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RUN-TIME SYSTEM 




Installation 

Part numbers: 690-211 70-nnn 
690-21869-nnn 

• Installation and upg^rade 

• Set up Multidrop and UPS 

Using the AOM'" Menu System 

Part number: 690-18055-nnn 

• Easy-to-use menus to 
access programs 

• Menu Manager to add, update, 
remove menus 

Operations Guide 

Part number: 690-211 71 -n/in 

• System administration 

• Accounting, file systems 

• Backups, port setup 

• Communications (UUCP) 

• Error messages 

Reference (C) 

Part number: 690-22869-nnn 

• Commands (C) 

Reference (M) 

Part number: 690-22870-nnn 

• Miscellaneous files (M) 
User's Guide 

Part number: 690-21 178-nnn 

(Not shipped with the Run-time system) 

• Basic concepts and tasks 

• Vi, ed, mail, awk, sed 

• Shells: sh aad csh 



TEXT PROCESSING SYSTEM 





DEVELOPMENT SYSTEM 

Set part number: 690-21585-000 

Reference (CP, S, F) 



• Programming commands (CP) 

• System calls, library routines (S) 
. File formats (F) 

Programmer's Guide 

. Make, sees 

• Lex, yacc 

• Signals, system resources, 
device drivers 

• Adb, sdb 

• Shared libraries 

C Compiler Library and User's Guide 

• I/O functions, pipes 

• Curses, terminfo 

• Assembly routines 

. As, cc, COFF, lint. Id 

• Error processing 

• Character and string processing 

C Compiler Language Reference 

• Elements of C 

• Program structure 

• Declarations, expressions 

• Statements, functions 

• Preprocessor directives 

Macro Assembler User's Guide 
and Reference 

• How to use masm 

• Error messages 

• Type declarations 

• Operands, expressions 

• Directives, file control 

• Instruction summary 



DOCUMENTER'S WORKBENCH'" 

Part numbers: 690-15843-nnn 
690-15844-nnn 

• Mm macros, reference 
. Nroff, troff, tbl, eqn 



"o order the User's Guide or any of the above manuals, call 408/434-6688, ext. 3004 
nd give the manual title and part number. 



Permuted Index 



The Permuted Index on the following pages contains a listing of 
programs, utilities, files, etc. in the Altos System V Run-time 
and Development Systems. These programs are described in the 
Altos System V Reference. Volume 1 of the Reference contains the 
Run-time system commands (C) and miscellaneous (M) sections. 
Volume 2 contains the Development system programming commands 
(CP), system calls and library routines (S), and file formats (F). 
Entries in each section are in alphabetical order. 



NOTE 

These programs, utilities, files, etc. are 
subject to change. 



The table that follows contains a description of each section and 
its location. 
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Permuted Index 



Description Section Manual 



Run-time commands C Reference (C) 

Miscellaneous ~ programs M Reference (M) 

and system files used for 
system maintenance and to 
access devices 



Programming commands 

System calls and library 
routines for C and assembly 
language programming 

File formats ~ programs 
and system files not de- 
fined in the M section 



CP Reference (CP, S, F 

S Reference (CP, S, F 

F Reference (CP, S, F 
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asCCP) 

13tol(S) ltol3(S) convert between 
tk(C) paginator for Tektronix 
integer and base-64 ASCII string 

abs(S) return integer 
ceil(S) fabs(S) floor, ceiling, and 
tloor(S) fmod(S) floor, ceiling, and 

requests 
settime(C) change the 
touch(C) update 
utime(S) set file 
login (C) give you system 
sputKS) sgetl(S) 
dos(C) 
sadp(M) disk 
Idfcn(F) common object file 
sdwaitv(S) synchronize shared data 
sdenter(S) sdleave(S) synchronize 
waitsem(S) nbwaitsem(S) wait and check 
clock (M) provide 
getutent(S) utmpname(S) endutent(S) 
getut(S) setutent(S) getutline(S) 
access(S) determine 
file 

C3plit(C) split files 
acct(S) enable or disable process 
acct(M) format of per-process 
acct (C) 

file 
accounting 

trig(S) sln(S) cos(S) tan(S) asinCS) 
killalKC) kill all 
sar(C) system 
sar(H) system 
sact(CP) print current SCCS file edit 
debugger 
add.hd(C) 
nl(C) 

map badblock(C) 
Ipinit(M) 
putenv(S) change or 

add.hd(C) add an 
upgrade. hd(C) upgrade an 
files 

admin (CP) create and 
ua(C) user 
uadinin(S) 
machinery 

mail alias file 
alarm (S) set a process 

brk(S) sbrk(S) change data segment space 



386 Assembler 
3-byt6 integer 
4014 



and long integer 



a641(S) 164a(S) convert between long 

abort (S) generate an lOT fault 

absolute value 



absolute value functions floor (S) 
absolute value functions 



abs(S) return integer absolute value 

accept (C) reject (C) allow/prevent print 
access and modification dates of files _ 
access and modification times of a file 

access and modification times 

access 

access long integer data 

access MS-DOS files 

access profiler 

access routines 

access adgetv(S) 



access to a shared data segment 

access to semaphore resource 

access to the time-of-day chip 
access utmp file entry getut(S) 

access utmp file entry 

accessibility of a file 



access(S) determine accessibility of a 

according to context 

accounting 



ccounting file 



accounting system 

acct(C) accounting system 

acct(N) format of per-process accounting 

acct(S) enable or disable process 

acos(S) trigonometric functions 

active processes 



activity report package 
activity report package 
activity 



adb(C) invoke x.out general purpose 

add an additional hard disk 

add line numbers to a file 



add new bad sectors to the bad sector 

add new line printers 

add value to environment 



add.hd(C) add an additional hard disk 

additional hard disk 

additional hard disk 



admin(CP) create and administer SCCS 

administer SCCS files 

administration program 

administrative control 



aftp(C) transfer files between Altos 
aliases (M) mail alias file 



aliashash(M) rebuild data base for 
alarm clock 



alanii(S) set a process alairm clock 
allocation 



as(CP) 

13tol(S) 

tk(C) 

a641(S) 

abort (S) 

abs(S) 

floor(S) 

floor (S) 

abs(S) 

accept (C) 

settime(C) 

touch (C) 

utime(S) 

login(C) 

sputl(S) 

dos(c') 

sadp(M) 

Idfcn(F) 

sdgetv(S) 

sdenter(S) 

waitsem(S) 

clock (M) 

getut(S) 

getut(S) 

access(S) 

access(S) 

csplit (C) 

acct(S) 

acct(M) 

acct(C) 

acct(C) 

acct(M) 

acct (S) 

trig(S) 

killall(C) 

sar (C) 

sar(M) 

sact(CP) 

adb(C) 

add.hd(C) 

nl(C) 

badblock(C) 

Ipinit(M) 

putenv(S) 

add.hd(C) 

add.hd(C) 

upgrade. hd(C) 

admin (CP) 

admin (CP) 

ua(C) 

uadmin(S) 

aftp{C) 

aliases (M) 

aliashash(M) 

alarm(S) 

alarm(S) 

brk(S) 
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free(S) realloc(S) fast main memory 
malXoc(S) main memory 
mallopt(S) calloc(S) fast main memory 
terminal mesg(C) 
get and set maximum number of users 
accept (C) reject (C) 
aftp(C) transfer tiles between 
lex(CP) generate programs for lexical 
editor output 
dc(C) 
bc(C) 

cpio(F) format of cpio 
ar(F) 
xar(F) 

the archive header of a member of an 
tar(C) 

file Idahread(S) read the 
streaming tape 
ar(CP) maintain 
xar(CP) maintain 
cpio(C) copy file 
ranlib(CP) convert 



varargs(F) handles variable 
getopt(S) get option letter from 
expr(C) evaluate 
echo(C) echo 
bc(C) arbitrary-precision 
asa(C) interpret 
characters 
ascii(N) map of the 
convert between long integer and base-64 



time to string ctime(S) tzset(S) 
trig(S) sin(S) cos(S) tan(S) 

a.out(F) format of 
as (CP) 386 
maam(CP) invoke the macro 
assert (S) verify program 

setbuf(S) setvbuf(S) 
trla(S) atan(S) 
trio(S) 
later time 

double-precision nmber strtod(S) 
strtol(S) atoKS) 
Integer strtoKS) 
sdget(S) sdlreeCS) 
reboot (C) 
reboot the system 
language 

wait(C) wait completion of 
finc(H) fast incremental 
ckbupscd(H) check file system 



allocator malloc(S) 
allocator 



malloc(S) 
malloc(S) 
malloc(S) 
mesg(C) 
numusers ( S ) 
accept (C) 
aftp(C) 
lex (CP) 
a.out(F) 
dc{C) 
bc(C) 
cpio(F) 
ar(F) 
xar(F) 
Idahread(S) 
tar(C) 
Idahread(S) 
archive (C) 
ar(CP) 
xar(CP) 
cpio(C) 
ranlib(CP) 
ar(CP) 
ar(F) 

varargs(F) 
getopt(S) 
expr(C) 
echo(C) 
bc(C) 
a8a(C) 
asa(C) 
ascii(M) 
a641(S) 
ascii(M) 
as (CP) 
ctime(S) 
trig(S) 
asktime(C) 
a.out(F) 
as(CP) 
maBm(CP) 
assert (S) 
assert (S) 
setbuf (S) 
trig(S) 

atan(S> atan2(S) trigononetric functions trig(S) 

at(C) batch(C) execute commands at a at(C) 

atof(S) convert string to strtod(S) 

strtol(S) 
StrtoKS) 



allocator malloc(S) mallinfo(S) 

allow or disallow messages sent to a 

allowed to log in numusers (S) 

allow/prevent print requests 

Altos machines 

analysis 

a.out(F) format of assembler and link 

arbitrary precision calculator 

arbitrary-precision arithmetic language 

archive 

archive file format 

archive file format 

archive file Idahread(S) read 

archive files 

archive header of a member of an archive 

archive (C) save a file system to a 

archives and libraries 

archives and libraries 

archives in and out 

archives to random libraries 

ar(CP) maintain archives and libraries _ 

ar(F) archive file format 

argument list 

argument vector 

arguments as an expression 

arguments 

arithmetic language 

asa carriage control characters 

asa(C) Interpret asa carriage control 

ASCII character set 

ASCII string a641(S) 164a(S) 

ascii(M) map of the ASCII character set 

as (CP) 386 Assembler 

asctime(S) cftime(S) convert date and 

asin(S) acos(S) trigonometric functions 

asktime(C) set the system time of day 

assembler and link editor output 

Assembler 

assembler 

assertion 

assert (S) verify program assertion 

assign buffering to a stream 

atan2(S) trigonometric functions 



atol(S) convert string to integer 
atol(S) atol(S) convert string to 



attach and detach a shared data segment _ sdget(S) 

automatically reboot the system reboot (C) 

autoreboot(C) automatically autoreboot(C 

awk(C) pattern scanning and processing awk(C) 



background processes 
backup 



backup schedule 



wait(C) 
finc(M) 
ckbupscd(M) 
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Erec(M) recover files from a 
:k(C) add new bad sectors to the 
badblock(C) add new 
bad sector map 

convert between long integer and 
of pathnames 
time at(C) 
language 
diff 
cb(CP) 

bessel(S) jO(S) yO(S) 



bfs(C) scan 
fwrite(S) fread(S) 
whereis(C) locate source, 
bsearch (S) 

tfind(S) tdelete(S) twalk(S) manage 
creatsem(S) create a 
reset (C) reset the teletype 
ssp{C) remove consecutive 
sync(S) update super 
df(M) report number of free disk 
sum(C) calculate checksum and count 
boot (M) 

mkboot(M) convert object file to 
table mkunix(M) make 
table mkunix(M) make 



shutdown (M) 
multiuaer(C) singleuser (C) 
allocation 
table 

stdio(S) standard 
setbuf(S) 8etvbuf(S) assign 
mknod(C) 
bsh(C) invoke the 
digest (C) create menu system(8) for the 
menus (M) format of 
swab ( S ) swap 
cc(CP) invoke the 
xcc(CP) invoke the XENIX 
cflow(CP) generate 
cpp(CP) the 
lint (CP) check 
cxref(CP) generate 
ctrace(CP) 
cb(CP) beautify 
xref(CP) cross-reference 
xstr(CP) extract strings from 
list (CP) produce 
create an error message file from 
create an error message file from 



back-up tape frec(M) 

bad sector map badblock(C) 

badblock(C) 
badblock (C) 
banner (C) 
a641(S) 
basename(C] 
at(C) 
bc(C) 
bdiff (C) 
cb(CP) 
bessel(S) 
bessel(S) 
bfs(C) 
bfs(C) 
fwrite(S) 
whereis (C) 
bsearch ( S ) 
tsearch(S) 
creatseni(S) 
reset (C) 
S8p(C) 
sync(S) 
df (M) 
sum(C) 
boot(M) 
mkboot ( M ) 
mkunix(M) 
mkunix(M) 
boot(M) 

brc(M) system initialization procedure brc(M) 

bring system to single-user or shutdown _ shutdown(M) 

bring system up multi/single-user mode multiuser (C) 

brk(S) sbrk(S) change data segment space brk(S) 
bsearch (S) binary search of a sorted bsearch (5) 



bad sectors to the bad sector map 

badblock(C) add new bad sectors to the _ 

banner(C) print large letters 

base-64 ASCII string a641(S) 

basename(C) dirname(C) deliver portions 

batch (C) execute commands at a later 

bc(C) arbitrary-precision arithmetic 

bdiff (C) compare files too large tor 

beautify C programs 

Bessel functions 

bessel(S) jO(S) yO(S) Bessel functions _ 

bfs(C) scan big files 

big files 

binary input/output 

binary, or manual for program 

binary search of a sorted table 

binary search trees tsearch(S) 

binary semaphore 

bit 

blank lines 

block 

blocks and inodes 

blocks in a file 

boot program 

bootable object file 

bootable system file with driver symbol 
bootable system file with kernel symbol 
boot(M) boot program 



bsh(C) invoke the Business shell 

buffered input/output package 

buffering to a stream 

build special files 

Business shell 

Business shell 



Business shell menu system 

bytes 

C compiler 

C compiler 



C flow graph 

C Language Preprocessor 

C language usage and syntax 

C program cross-reference 

C program debugger 

C programs 

C programs 

C programs 



C source listing from COFF file 

C source mkstr(C) 

C source mkstr(CP) 

cal(C) print a calendar 



bsh(C) 
stdio(S) 
setbuf (S) 
mknod ( C ) 
bsh(C) 
digest (C) 
menus (M) 
swab ( S ) 
cc(CP) 
_xcc(CP) 
cflow(CP) 
cpp(CP) 
lint (CP) 
cxref (CP) 
ctrace(CP) 
cb(CP) 
xref (CP) 
xstr(CP) 
list(CP) 
mkstr (C) 
mkstr(CP) 
cal(C) 
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dc(C) arbitrary precialon 
cal(C) print a 

cu(C) 

stat(F) return data by stat aystem 

malloctS) niallinfo(S) mallopt(S) 
intro(S) introduce syatem 
line printer lp(C) 
termcap(M) terminal 
terminfo(M) terminal 
description 
asa(C) Interpret asa 



gencc(CP) create a front end to the 



sees delta 

absolute value functions floor(S) 
floor(S) ceil(S) faba(S) floor. 

floor(S) fmod(S) floor. 



string 



Tie(S) 



:t(S) asctime(S) 
brk(S) sbrk(S) 
passwd(C) 
chinod(S) 
putenv(S) 
chom ( S ) 
chown(C) charp(C) 
directory chiiiod(C) 
nice(S) 
chroot(S) 
chroot (C) 
s«»ap(C) 
of tiles settime(C) 
delta cdc(CP) 
chsize(S) 
delta(CP) make a 
cd(C) 
chdir(S) 

pipe(S) create an interprocess 
ungate (S) push 
cuserid(S) get 
9etc(S) getw(S) fgetc(S) gctchar(S) get 
putc(S) putchar(S) putii(S) tputc(S) put 
ascll(M) nap of the ASCII 
fgrep(C) search a file for a 
asa(C) interpret asa carriage control 
toascli(S) tolo«er(S) translate 
islower(S) Iscntrl(S) classify 
ispunct(S) Isascil(S) classify 
tr(C) translate 
wc(C) count lines. ««ords. and 

waltsem(S) nbwaltsein(S) wait and 
fsck(C) dfsck(C) 



calculator 

calendar 

calendar(C) invoke a reminder se 
call another UNIX system 



call 

calloc(S) fast main memory allocator 

calls, functions, and libraries 

cancel (C) send/cancel requests to LP 

capability database 

capability database 

captoinfo(M) convert termcap to termi 

carriage control characters 

cat(C) concatenate and display files 

cb(CP) beautify C programs 

cc command 



cc(CP) invoke the C compiler 

cd(C) change working directory 

cdc(CP) change the delta commentary of 

ceil(S) fabs(S) floor, ceiling, and 

ceiling, and absolute value functions 
ceiling, and absolute value functions 

cflow(CP) generate C flow graph 

cftime(S) convert date and time to 

change data segment space allocation 

change login password 

change mode of file 



change or add value to environment 

change owner and group of a file 

change owner or group ID 

change permissions of a file or 

change priority of a process 

change root directory 



change root directory for command 

change swsp device configuration 

change the access and modification dates 

change the delta commentary of SCCS 

change the file size 

change to an SCCS file 

change working directory 

change working directory 

channel 

character back into input streaai 

character login name of the user 

character or word from a stream 

character or word on a stream 

character set 

character string 

characters 



characters conv(S) toupper(S) 
characters ctype(S) Isslphs(S) 
characters ctype(S) Isdigit(S) 

characters 

characters 



chdir(S) change working directory _ 
check access to semaphore resource 
check and repair file systens 
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lint (CP) 
ckbupscd(M) 
pwck(M) grpck(M) 
permissions file uucheck(M) 
rdchk(S) 

labelit(M) copy file system with label 
by fsck 
aum(C) calculate 
chown(C) 

times (S) get process and 
wait(S) wait for 
provide access to the time-of-day 
libraries 
directory 



ID 



file 
command 



schedule 

isalpha(S) islower(S) iscntrl(S) 
isdigit(S) ispunct(S) isascli(S) 
inir(M) 

strclean(M) STREAMS error logger 
uucleanup(M) uucp spool directory 
clri(M) 
clear(C) 

inquiries ferror(S) fileno(S) 
csh(C) shell command interpreter with 
alarm(S} set a process alarm 
time-of-day chip 

STREAMS driver 
Idclose(S) Idaclose(S) 
close (S) 
fclose(S) fflush(S) 
haltsy8(C) 

directory operations directory(S) 



dis(CP) object 
ldclo8e(S) Idsclose(S) close a 
Idfhread(S) read the file header of a 
list (CP) produce C source listing from 
to line number entries of a section of a 
to relocation entries of a section of a 
an indexed/named section header of a 
the index of a symbol table entry of a 
read an indexed symbol table entry of a 
seek to the symbol table of a 
remove symbols and line numbers from 
convert an object file from OMF to 
manipulate line number entries of a 
Idgetname(S) retrieve symbol name for 



check C language usage and syntax 
check file system backup schedule 

check password/group file 

check the uucp directories and 



check to see if there is data to be read 
checking volcopy(M) 



checklist (M) list file systems processed 

checksum and count blocks in a file 

chgrp(C) change owner or group ID 

child process times 



child process to stop or terminate 
chip clock (M) 



chkshllb(CP) tool for comparing shared 
chmod(C) change permissions o 
chmod(S) change mode of file 



lint (CP) 
ckbupscd(M) 
pwck(M) 
uucheck(M) 
rdchk(S) 
volcopy (M) 
checklist (M) 
sum(C) 
chown ( C ) 
t imes ( S ) 
wait(S) 
clock(H) 
chkshlib{CP) 
le or chmod(C) 
chmod(S) 



chown (C) chgrp(C) change owner or group _ chown (C) 



chown (S) change owner and group of a 
chroot(C) change root directory for _ 

chroot(S) change root directory 

chsize(S) change the file size 

ckbup3Cd(M) check file system backup 

classify characters ctype(S) 

classify characters ctype(S) 



clean the file system and executes init 

cleanup program 

cleanup 

clear inode 



clear terminal screen 

clear (C) clear terminal screen 

clearerr(S) feof(S) stream status 

C-like syntax 

clock 



clock (M) provide access to the 

clock(S) report CPU time used 

clone (N) open any minor device on 
close a COFF file 



close a file descriptor 

close or flush a stream 

close the file systems and halt the CPU 

closedir(S) rewinddir(S) seekdlr(S) 

close (S) close a file descriptor 

clri(M) clear inode 

cmp(C) compare two files 

code disassembler 

COFF file 

COFF file 

COFF file 

COFF file ldl8eek(S) seek 

COFF file IdrseekCS) seek 

COFF file Idshread(S) read 

COFF file Idtblndex(S) compute 

COFF file Idtbread(S) 

COFF file Idtbseek(S) 

COFF file 8trip(CP) 

COFF flxobj(CP) 



COFF function Idlread(S) Idlltem(S) 
COFF symbol table entry 



chown (S) 

chroot (C) 

chroot(S) 

chsize(S) 

ckbupscd(M) 

ctype(S) 

ctype(S) 

inir(M) 

strclean(M) 

uucleanup(H) 

clri(M) 

clear(C) 

clear(C) 

ferror (S) 

csh(C) 

alarm(S) 

clock(M) 

clock(S) 

clone(M) 

Idclose(S) 

close(S) 

fclose(S) 

haltsys(C) 

dlrectory(S) 

close(S) 

clri(M) 

cmp(C) 

dis(CP) 

Idclose(S) 

Idfhread(S) 

list (CP) 

Idlseek(S) 

Idrseek(S) 

Idshread ( S ) 

Idtbindex(S) 

Idtbread(S) 

Idtbseek(S) 

strip(CP) 

fixobj (CP) 

Idlread(S) 

Idgetname(S) 
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comb (CP) 
nice(C) run a 
chroot(C) change root directory for 
env(C) set environment for 
gencc(CP) create a front end to the cc 
nohup(C) run a 
■etpgrp(C) execute 
sh(C) rsh(C) invoke the shell 
cah(C) shell 
uux(C) execute 
getopt(C) parse 
uuxqt (M) execute remote 
system(S) issue a shell 
time(C) time a 
at(C) batch(C) execute 
cron(C) execute 
rc2(M) 

install (M) install 
intro(C) introduce 
Intro(CF) introduce software development 
rcO(M) 

xargs(C) construct and execute 
two sorted files 
mcs(CP) manipulate the object file 
cdc(CP) change the delta 
Idfcn(F) 
cpr8(CP) compreeae a 
Idopen(S) Idaopen(S) open a 
linenuro(F) line number entries in a 
nm(CF) print name list of 
reloc(F) relocation of information for a 
scnhdr(F) section header for a 
syniB(F) 
conv(CP) convert 
filehdr(F) file header for 
aize(C) print section sizes of 
seek to the optional file header of a 
conm(C) select/reject lines 
glossary(C) define 
ipcs(C) report inter-process 
stdipc(S) ftok(S) standard interprocess 
dircmp (C) 
sdiff (C) 
bdiff (C) 
infocmp(H) 
diff3(C) 
cmp(C) 
diff (C) 
sccsdiff (CP) 
chkshllb(CP) tool for 
regcmp(S) 

regexp(F) regular expression 
routines regexp(S) 
regcmp(CP) 

tic(C> 

cc(CP) invoke the C 



comb(CF) combine SCCS deltas 

combine SCCS deltas 

command at a different priority 
command 



command execution 
command 



command immune to hangups and quits 

command in a new process group 

command interpreter 

command interpreter 



<ith C-like syntax 

command on remote UNIX 

command options 

command requests 

command 

command 

commands at a later time 



commands at specified times 

commands tor multi-user environment 

commands 

commands 

commands 



comb (CP) 
comb (CP) 
nice(C) 
chroot (C) 
env(C) 
gencc(CP) 
nohup(C) 
aetpgrp(C) 
sh(C) 
csh(C) 
uux(C) 
getopt(C) 
uuxqt (M) 
sy8tem(S) 
time(C) 
at(C) • 
cron(C) 
rc2(M) 
install(M) 
intro(C) 
intro(CP) 
rcO(M) 
xargs(C) 



commands to stop the operating system 

commands 

comm(C) select/reject lines common to comm(C) 

comment section 

commentary of SCCS delta 

coranon object file access routines 
common object file 



common object file for reading 

comnon object file 

connon object file 

comaon object file 

coonon object file 



mcs(CP) 
cdc{CP) 
Idfcn(F) 
cprs(CP) 
Idopeh(S) 
linenum(F) 
nm(CP) 
reloc(F) 
scnhdr (F) 



coanon object file symbol table format syms(F) 

cosMion object files 

common object files 

coasBon object files 



comaon object Idohseek(S) 

connon to two sorted files 

comnon UNIX terms and symbols 

cooBiunication facilities status 

communication package 

compare directories 



compare files side-by-side 

compare files too large for diff 

compare or print terminfo descriptions 

compare three files 

compare two files 

compare two text files 

compare two versions of 



SCCS file 



comparing shared libraries 

compile a regular expression 
compile and match routines 



compile regular expression and match 

compile regular expressions 

compile terminfo source 

compiler 



conv(CP) 
filehdr(F) 
size(C) 
Idohseek(S) 
comii(C) 
glossary (C) 
ipcs(C) 
stdipc(S) 
dircmp(C) 
sdiff (C) 
bdiff (C) 
infocmp(M) 
diff3(C) 
cmp(C) 
diff (C) 
sccsdiff (CP) 
chkshlib(CP) 
regcmp(S) 
regexp(F) 
regexp(S) 
regcmp(CP) 
tic(C) 
cc(CP) 



PI-8 



Permuted Index 



xcc(CP) invoke the XENIX C 
yacc(CP) invoke a 
erf(S) erfc(S) error function and 
wait(C) wait 
pack(C) pcat(C) unpack (C) 
cprs(CP) 

entry of a COFF file Idtbindex(S) 
cat<C) 
Idunix(M) 
master (M) master 
printers (M) print spooler 
sysconf(C) get system 
sysconf(S) get system 
pconfig(C) set port 
swap(C) change swap device 
shutype(M) UPS shutdown 
Ipadmin(M) 

establish an out-going terminal line 
ssp(C) remove 
system 
system 

math(F) math functions and 
unistd(F) file header for symbolic 
file header for implementation-specific 
mkfs(n) 
xaras(C) 
uutry(M) 

errprint(M) display error log 
recover<C) restore 
dump.hd(C) dump 
ls(C) list 

cspllt(C) split files according to 
fcntl(S) file 
uadmin(S) administrative 
uustat(C) UUCP status inquiry and job 
vc(CP) version 
asa(C) interpret asa carriage 
ioctl(S) 

IEEE floating point environment 
IEEE floating point environment 
IEEE floating point environment 
XEEE floating point environment 
IEEE floating point environment 
init(M) process 
msgctl(S) message 
seactKS) semaphore 
ahaictl(S) shared memory 
fcntl(F) file 

tenn(M) 
f ixobj (CP) 
dd(C) 
ranlib(CP) 
integers 13tol(S) ltol3(S) 
ASCII string a641(S) 164a (S) 
conv<CP) 

ctime(S) gmtime(S) localtime(S) 



compiler-compiler 

complementary error function 

completion of background processes 
compress and expand files 



compress a common object file 

compute the index of a symbol table 

concatenate and display files 

configurable kernel linker 

configuration database 

configuration file 



configuration information 
configuration information 

configuration 

configuration 



configuration utility 

configure the LP spooling system 

connection dial(S) 

consecutive blank lines 

console display 

console keyboard 

constants 

constants 



constants limits (F) 

construct a file system 

construct and execute commands 

contact remote system with debugging 

contents 

contents of a file system from tape _ 

contents of a hard disk to tape 

contents of directories 

context 

control 

control 

control 

control 

control characters 

control device 



control f pgetround(S) fpgetmask<S) 

control fpgetround(S) fpgetstlcky (S) 

control fpgetround(S) tpsetmask(S) 

control fpgetround(S) fpsetround(S) 
control fpgetround(S) fpsetsticky(S) 

control initialization 

control operations 

control operations 

control operations 

control options 



conv(CP) convert common object files 
conventional names for terminals 



convert an object file from OMF to COFF 
convert and copy a file 



convert archives to random libraries 

convert between 3-byte Integers and long 
convert between long integer and base-64 

convert common object files 

convert date and time to string 



xcc (CP) 

yacc(CP) 

erf (S) 

wait(C) 

pack(C) 

cprs(CP) 

Idtblndex(S) 

cat(C) 

Idunix(M) 

master (M) 

printers (M) 

sysconf (C) 

syscont (S) 

pconfig(C) 

swap(C) 

shutype(M) 

Ipadmin(M) 

dial(S) 

3sp(C) 

display (M) 

keyboard (M) 

math(F) 

unistd(F) 

limits(F) 

mkfs(H) 

xargs(C) 

uutry (M) 

errprint (M) 

recover (C) 

dump.hd(C) 

ls(C) 

csplit(C) 

fcntl(S) 

uadmin(S) 

uustat (C) 

vc(CP) 

asa(C) 

ioctl(S) 

fpgetround(S) 

fpgetround(S) 

fpgetround(S) 

fpgetround(S) 

fpgetround(S) 

init(M) 

msgctl(S) 

semctl(S) 

shmctl(S) 

fcntl(F) 

conv(CP) 

term(M) 

f ixobj (CP) 

dd(C) 

ranlib(CP) 

13toi(S) 

a641($) 

conv(CP) 

ctime(S) 
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ctime(S) l:zaet(S) asctiine(S> cftiine(S) 
ecvt ( S ) 

scanf(S) tscant(S) ■■canf(S) 
file mkboot(M) 
FORTRAN rat for (CP) 
number Btrtod(S) atof(S) 
strtoKS) atol(S) atoi(S) 
captoinfo(M) 
unlts(C) 
translate characters 
dd(C) convert and 
fcopy (C) 
cpio(C) 

volcopy(M) labelit(M) 
cp(C) 

uucp(C) uulog(C) uunaine(C) 
copy(C) 
tra(C) 

public UNIX-to-UNlX ayatem file 
core(F) format of 
Binh(S) 

trigonometric functions trig(S) sinCS) 
sum(C) calculate checksum and 
wc(C) 

cpio(F) format of 



close the file systems and halt the 
clock (S) report 
creatsem(S) 
gencc(CP) 
tmpnam(S) tempnam(S) 
one creat(S) 
fork ( S ) 
mkshllb(CP) 
ctagB(C) 
tee(C) 
tmpfile(S) 
source mkstr(C) 
source mk*tr(CP) 
pipe(S) 
admin (CP) 
Shell digest (C) 
makedevs(M) 
makettys(M) 
uinask(S) set and get file 
existing one 



convert date and time to atr 
convert floating-point numbe 
convert formatted input 



no 



i(S) 



tring _ ecvt(S) 

acant(S) 

convert object file to bootable object mkboot(M) 



convert rational FORTRAN to standard 
convert string to double-precision _ 

convert string to integer 

convert termcap to terminfo descript 
convert units 



conv(S) toupper(S) toascii(S) tolower(S) 

copy a file 

copy a floppy diskette 

copy file archives in and out 

copy file system with label checking 

copy files 

copy files from UNIX to UNIX 

copy groups of files 

copy out 



ratfor(CPl 
atrtodO ) 
StrtoKS) 
captoinfo(M) 
units(C) 
conv(S) 
dd(C) 
fcopy (C) 
cpio(C) 
volcopy (M) 
cp(C) 
uucp(C) 
copy(C) 
tra(C) 
uuto(C) 
copy (C) 
core(F) 
core(F) 
sinh(S) 
trig(S) 
sum ( C) 
wc(C) 
cp(C) 
cpio(F) 
cpio(C) 
cpio(F) 

cpp(CP) the C Language Preprocessor cpp(CP) 

cprs(CP) compresse a common object file _ cprs(CP) 

cpset(C) Install utilities cpset(C) 

haltsya(C) 
clock(S) 
creat8em(S) 

create a front end to the cc comnand gencc(CP) 

create a name for a temporary file tmpnam(S) 

create a new file or rewrite an existing 



file as it grows 

copy uuto(C) uupick(C) 

copY(C) copy groups of files 

core image file 

core(F) format of core image file 

co8h(S) tanh(S) hyperbolic functions 

cos(S) tan(S) asin(S) acos(S) 

count blocks in a file 

count lines, words, and characters 

cp(C) copy files 

cpio archive 

cpio(C) copy file archives in and out 
cpio(F) format of cpio archive 



CPU haltsys(C) 

CPU time used 

create a binary semaphore 



create a new process 

create a shared library 
create a tags file 



create a tee in a pipe 

create a temporary file 

create an error message file from C 
create an error message file from C 
create an interprocess channel 



times 

crontab(C) manage user 



create and administer SCCS files 

create menu systeffl(s) for the Business 

create special device files 

create tty special files 

creation mask 

Great (S) create a new file or rewrite an 

creatsem ( S ) create a binary semaphore 

cref(CP) make a cross-reference listing 

cron(C) execute commands at specified 

crontab files 



crest (S) 
fork(S) 
mkshlib(CP) 
ctags(C) 
tee(C) 
tmpf ile(S) 
mkstr(C) 
mk8tr(CP) 
pipe(S) 
admin (CP) 
digest (C) 
makedevs(M) 
makettys(M) 
umask ( S ) 
creat(S) 
creatsera(S) 
cret(CP) 
cron ( C ) 
crontah(C) 
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xref (CP) 

cxref(CP) generate C program 
cref(CP) make a 
functions 
C-like syntax 
context 



terminal 
date and time to string 
convert date and time to string 

iscntrl(S) classify characters 
isascii(S) classify characters 

tty(C) get the 
sact(CP) print 
uname(C) print the 
uname(S) get name of 
whoami(C) print effective 
find the slot in the utmp file of the 
getcwd(S) get path name of 
scr_dump(F) format of 
optimization package 
spline (C) interpolate smooth 
the user 
cross-reference 
Ipd(M) line printer 
strerr(M) STREAMS error logger 
xpd(H) transparent printer 
sdgetv(S) sdwaitv(S) synchronize shared 
turn on/off 
3tat(F) return 
plock(S) lock process, text, or 
prof{CP) display profile 
exec8eg(S) make a 
synchronize access to a shared 
sdfree(S) attach and detach a shared 
brk(S) sbrk(S) change 
sputl(S) sgetl(S) access long integer 
rdcbk(S) check to see if there is 
types (F) primitive system 
query terminfo 
dbminit(S) fetch(S) nextkey(S) perform 
firstkey(S) store(S) fetch(S) perform 
master (M) master configuration 
termcap(M) terminal capability 
terminfo(M) terminal capability 
ctirae(S) gmtime(S) localtime(S) convert 
tzset(S) asctime(S) cftime(S) convert 
date(C) print and set the 

change the access and modification 
database functions dbm(S) 
perform database functions 
perform database functions 



crontab(C) manage user cronta 

cross-reference C programs 

cross-reference 



cross-reference listing 

crypt(S) password and file encryption 
csh(C) shell command interpreter with 

csplit(C) split files according to 

ctags(C) create a tags file 



ct(C) spawn getty to a remote terminal 
ctermid(S) generate file name for 



crontab(C) 
xref (CP) 
cxref (CP) 
cref (CP) 
crypt (S) 
csh(C) 
csplit(C) 
ctags(C) 
ct(C) 

ctermid(S) 



ctlme(S) gmtime(S) localtime(S) convert 
ctime(S) tzset(S) asctime(S) cftime(S) 

ct race (CP) C program debugger 

ctype(S) isalpha(S) islower(S) 

ctype(S) isdigit(S) ispunct(S) 

cu(C) call another UNIX system 

current port name 



cti 



i(S) 



current SCCS file edit activity 

current UNIX information 

current UNIX system 

current user id 



current user ttyslot(S) 

current working directory 

curses screen image file 

curses(S) terminal screen handling and 



cuserid(S) get character login name of 

cxref (CP) generate C program 

daemon 

daemon 

daemon 

data access 

data collector 

data by stat system call 

data in memory 

data 

data region executable 

data segment sdenter(S) sdleave(S) 

data segment sdget(S) 



data segment space allocation 
data 



data to be read 

data types 

database 



database functions dbm(S) 
database functions dbm(S) 

database 

database 

database 



date and time to string 

date and time to string ctime(S) 
date 



date(C) print and set the date 
dates of files 8ettime(C) 



dbminlt(S) fetch(S) nextkey(S) perform 
dbm(S) dbi»init(S) fetch(S) nextkey(S) 
dbm(S) firstkeyCS) store(S) fetch(S) _ 



ctime(S) 

ctrace(CP) 

ctype(S) 

ctype(S) 

cu(C) 

tty(C) 

3act(CP) 

uname(C) 

uname ( S ) 

whoami ( C ) 

ttyslot(S) 

getcwd(S) 

scr_dump(F) 

curses (S) 

spline(C) 

cuserid(S) 

cxref(CP) 

Ipd(M) 

strerr (M) 

xpd(M) 

8dgetv(S) 

sadcon(H) 

stat(F) 

plock(S) 

prof (CP) 

execseg(S) 

sdenter(S) 

sdget(S) 

brk(S) 

sputKS) 

rdchk(S) 

types (F) 

tput(C) 

dbm(S) 

dbm(S) 

master(M) 

tenncap(M) 

terminfo (M) 

ctime(S) 

ctime(S) 

date(C) 

date(C) 

settime(C) 

dbm(S) 

dbm(S) 

dbm(S) 
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adb(C) invoke x.out general purpose 
ctrace(CP) C program 
fsdb(M) file system 
Bdb(C) symbolic 
uutry(M) contact remote system with 
default (M) 
timezone(M) set 
directory 
glossary (C) 
sysdef(M) output system 
basename(C) dirname(C) 
tail(C) 

change the delta commentary of SCCS 
cdc(CF) change the 
rmdel(CP) remove a 

comb (CP) combine SCCS 
err3top(C) terminate error-logging 
captoinfo(M) convert termcap to terminfo 
infocmp(M) compare or print terminfo 
cloae(S) close a file 
dup(S) dup2(S) duplicate an open tile 
sdget(S) adfree(S) attach and 
access (S) 
dtype(C) 
file(C) 
fstyp(M) 
drive Bizefs(C) 
whodo(M) 

intro(CP) introduce software 
swap(C) change swap 
makedevB(M) create special 
fold long lines for finite width output 
devlnfo(C) display 
ioctl(S) control 
devnm(C) identify 
clone (H) open any minor 

files reside 
and inodes 
fsck(C) 
line connection 
bdiff(C) compare files too large for 



nlce(C) run a comnand at a 
Business Shell 

uucheck(M) check the uucp 
dircnp(C) compare 
fleece(C) look for files in home 
unlink(H) link and unlink tiles and 
ls(C) list contents of 
mv(C) move (rename) tiles and 
rm(C) rmdir(C) remove files or 



dc(C) arbitrary precision calculator 

dd(C) convert and copy a file 

debugger 

debugger 

debugger 

debugger 

debugging on 



dc(C) 
dd(C) 
adb(C) 
ctrace(CP) 
fsdb(M) 
sdb(C) 
uutry(M) 
default (M) 
timezone(M) 

default (M) default program information default (M) 

define common UNIX terms and symbols glossary (C) 

definition sysdef(M) 

basename(C) 
tail(C) 
cdc(CP) 
cdc(CP) 
rmdel(CP) 



default program information directory 
default system time zone 



deliver portions of pathnames 

deliver the last part of a file 
delta cdc(CP) 



delta commentary of SCCS delta 
delta from an SCCS file 



delta(CP) make a change to an SCCS tile _ delta(CP) 



deltas 

demon 

description 
descriptions 

descriptor 

descriptor 



detach a shared data segment 

determine accessibility of a file 

determine disk type 

determine file type 



determine the tile system identifier 
determine the size of a logical disk 

determine who is doing what 

development commands 

device configuration 

device files 

device fold(C) 

device information 

device 

device name on which files reside 

device on STREAMS driver 



comb ( CP ) 
errstop(C) 
captoinfo(M) 
infocmp(M) 
closeCS) 
dup(S) 
sdget(S) 
access(S) 
dtype(C) 
file(C) 
tstyp(M) 
slzef8(C) 
whodo(M) 
intro(CP) 
swap(C) 
makedevs(M} 
fold(C) 
devinto(C) 
. ioctl(S) 
devnffl(C) 
clone (H) 



devinfo(C) display device information devinfo(C) 

devnm(C) Identify device name on which devnm(C) 

df (M) report number of tree disk blocks _ dt(M) 

dfsck(C) check and repair file systems fsck(C) 

dial(S) establish an out-going terminal _ dial(S) 

diff bdiff (C) 

ditt3(C) 

diff (C) 

nice(C) 



dift3(C) compare three files 



dltt(C) compare two text tiles 
different priority 



dlgest(C) create menu system(s) tor the _ digest(C) 



dlrcnp(C) compare directories 

directories and permissions tile 

directories 

directories 



directories link(M) 

directories 

directories 

directories 



dircmp(C) 

uucheck(M) 

dircmp(C) 

tie.-. -(C) 

linkiMi 

ls(Ci 

mv(Ci 

rm(CI 
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cd(C) change worliina 
chdlr(S) change working 
chtnod(C) change permlaaiona of a file or 
chroot(S) change root 
uucleanup(M) uucp spool 
default (M) default program information 
dir(H) format of a 
getdents(S) read 
dirent(F) file system independent 
unlink(S) remove 
chroot(C) change root 
get path name of current working 
mkdlr(C) make a 
mkdlr(S) make a 
pwd(C) print working 
closedlr(S) rewinddir(S) seekdlr(S) 
telldir(S) readdir(S) opendir(S) 
mknod(S) make a 
rmdir(S) remove a 
seekdir(S) directory operations 
opendir(S) directory operations 
directory entry 

basename(C) 
disable(C) 
acct(S) enable or 

mesg(C) allow or 
dis(CP) object code 
set terminal type, modes, speed, line 

add.hd(C) add an additional hard 
df(H) report number of free 
determine the size of a logical 
restore . hd(C) restore a hard 
options (M) floppy 
layout (M) manage hard 
maintain 

dump.hd(C) dump contents of a hard 
dtype(C) determine 
upgrade. hd(C) upgrade an additional hard 
du(C) summarize 
fcopy(C) copy a floppy 
for«at(C) format a floppy 
system console 
see(C) 
devinfo(C) 

vi(C) invoke a screen-oriented 
errprint(M) 
cat(C) concatenate and 

hd(C) 
od(C) 
prof (CP) 

set up terminal to print screen 
hdr(C) 
who(C) 

hypot(S) Euclidean 



directory 

directory 

directory 

directory 

directory cleanup 

directory 

directory 



directory entries and put in 

directory entry 

directoiry entry 

directory for command 

directory getcwd(S) 

directory 

directory 



directory name 

directory operations directory(S) 

directory operations directory(S) 

directory, or a special or ordinary tile 

directory 

directory(S) closedir(S) rewinddir(S) 

directory (S) teHdir(S) readdir(S) 

dirent(F) file system independent 

dir(M) format of a directory 

dirname(C) deliver portions of pathnames 

disable logins on a port 

disable process accounting 

disable(C) disable logins on a port 

disallow messages sent to a terminal 

disassembler 



discipline uugetty(n) 

dis(CP) object code disassembler 
disk 



disk blocks and inodes 
disk drive sizefa(C) _ 
disk from tape 



disk installation menu 

disk partitions 

disk partitions 

disk to tape 

disk type 

disk 

disk usage 

diskette 

diskette 

display 



display a file 

display device information 
display editor 



display error log contents 
display files 



display files in hexadecimal format 

display files in octal format 

display profile data 

display pscreen(C) 



display selected parts of an object file 

display who is on the system 

distance function 



cd(C) 

chdir(S) 

chfflod(C) 

chroot (S) 

uucleanup(M) 

default (M) 

dir(M) 

getdentB(S) 

dirent(F) 

unllnk(S) 

chroot (C) 

getcwd(S) 

mkdir(C) 

mkdir(S) 

pwd(C) 

directorY(S) 

directorY(S) 

mknod(S) 

rmdir(S) 

directory (S) 

directory(S) 

dirent(F) 

dir(M) 

basename(C) 

disable(C) 

acct(S) 

disable(C) 

meag(C) 

dis(CP) 

uugetty (M) 

dis(CP) 

add.hd(C) 

df (M) 

sizefs(C) 

restore. hd(C) 

options (M) 

layout (M) 

fdlsk(C) 

dump . hd ( C ) 

dtype(C) 

upgrade. hd(C) 

du(C) 

fcopy(C) 

format (C) 

display(M) 
. aee(C) 

devinfo(C) 
. vi(C) 

errprint(M) 

cat(C) 
_ hd(C) 
. od(C) 
_ prof(CP) 

pscreen(C) 

hdr(C) 

who(C) 
hypot(S) 



PI-13 



Permuted Index 



whodo(M) determine who i« doing what 



UNIX 

strtod(S) atof(S) convert string to 
pseudo-random numbers 
lrand48(S) generate pseudo-random/ 
jrand48(S) generate pseudo- random/ 
graph (C) 
manufacturing drive(C) 
determine the size oC a logical disk 
utility program for a streaming tape 
during manufacturing 
open any minor device on STREAMS 
nix(N) make bootable system file with 



dump . hd ( C ) 
dump (CP) 
object file 
to tape 
descriptor dup(S) 
dup(S) dup2(S) 
descriptor 

drive (C) drive information written 
echo(C) 

string 

ed(C) red(C) invoke the 
program end(S) 

3act(CP) print current SCCS file 
edlt(C) invoke the 

ed(C) red(C) invoke the ed text 
edit(C) invoke the edit text 
ex(C) invoke a text 
Id(CP) invoke the link 
a.out(F) format of assembler and link 
sed{C) invoke the stream 
vi(C) invoke a screen-oriented display 
xld(CP) invoke the link 
whoaffli(C) print 
full regular expression 
enable(C) 
acct(S) 

Ipenabla(C) Ipdisable(C) 
crypt (S) password and file 
makekey(M) generate an 
gencc(CP) create a front 
entry getgrent(S) fgetgrent(S) 
file entry getpwent(S) tgetpwent(S) 
In program 

getut(S) getutent(S) utmpname(S) 

getdents(S) read directory 
xlist(S) fxlist(S) get name list 



dos(C) access MS-DOS files 

dos disk partitions 

double-precision number 

drand48(S) erand48(S) generate 
drand48(S) mrand48(S) nrand48(S) 
drand48(S) seed48(S) srand48(S) 
draw a graph 



ritten during 



whodo(M) 
dos(C) 
fdisk(C) 
strtod(S) 
drand48(S) 
drand48 (S) 
drBnd48(S) 
graph (C) 
drive (C) 
sizefs(C) 
tapeutil (C) 
drive(C) 
clone(M) 
mkunlx(M) 
dtype(C) 
du(C) 

dump . hd(C) 
dump ( CP ) 
dump ( CP ) 
dump . hd ( C) 
dup(S) 
dup(S) 
dup(S) 
drive (C) 
echo(C) 
echo(C) 
ecvt(S) 
ed(C) 
end(S) 
ed(C) 
sect (CP) 
•dit(C) 
edit(C) 
ed(C) 
edlt(C) 
ex(C) 
Id(CP) 
a.out(F) 
sed(C) 
vl(C) 
xld(CP) 
whoami (C) 
eorep(C) 
enable (C) 
acct (S) 
enable(C) 
Ipenable(C) 
crypt (S) 
makekey (M) 
gencc(CP) 

endgrent(S) setgrent(S) get group file getorent(S) 

endpwent(S) setpwent(S) get password getpwent(S) 

end(S) edata(S) etext(S) last locations _ end(S) 

endutent(S) access utmp file entry getut(S) 

enroll (C) 
getdents(S) 
xllat(S) 



drive information 

drive sizefs(C) 

drive tapeutil (C) 

drlve(C) drive information written 

driver clone (M) 

driver symbol table 

dtype(C) determine disk type 

du(C) summarize disk usage 

dump contents of a hard disk to tape 

dump selected parts of an object file _ 

dump(CP) dump selected parts of an 

dump.hd(C) dump contents of a hard disk 

dup2(S) duplicate an open file 

duplicate an open file descriptor 

dup(S) dup2(S) duplicate an open file _ 

during manufacturing 

echo arguments 

echo(C) echo srguments 

ecvt(S) convert floating-point number ti 

ed text editor 

edata(S) etext(S) last locations in 

ed(C) red(C) invoke the ed text editor 

edit activity 

edit text editor 

edit(C) invoke the edit text editor 

editor 

editor 

editor 

editor 

editor output 

editor 

editor 

editor 

effective current user id 

egrep(C) search file for pattern using 

enable logins on a port 

enable or disable process accounting 

enable(C) enable logins on a port 

enable/disable LP line printers 

encryption functions 

encryption key 

end to the cc conmand 



enroll(C) xsend(C) xget(C) secret mall 

•ntriea and put in a file 

entries frosi files 
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nliat(S) get 
llnentiin(F) line number 
Idlitem(S) manipulate line number 
Idlaeek(S) seek to line number 
IdrseekCS) aeek to relocation 
utmp(H) wtmp(M) fonaat of utmp and wtmp 
file system Independent directory 
endgrent(S) setgrent(S) get group file 
getgrnam(S) getgrgld(S) get group file 
setpwent(S) get password file 
getpwuld(S) get password file 
utmpname(S) endutent(S) access utmp file 
getutllne(S) access utmp file 
symbol name for COFF symbol table 
compute the Index of a symbol table 
Idtbread(S) read an Indexed symbol table 
putpwent(S) write password file 
unlink (S) remove directory 
execution 

proflle(M) set up 
fpgetmask(S) IEEE floating point 
fpgetsticky(S) IEEE floating point 
fpsetmask(S) IEEE floating point 
fpsetround(S) IEEE floating point 
fpsetstlcky(S) IEEE floating point 
environ (M) user 
env(C) set 
getenv(S) return value for 
prlntenv(C) print out the 
putenv(S) change or add value to 
rc2(M) commands for multi-user 
numbers drand48(S) 
error function erfCS) 
complementary error function 
sys_nerr ( S ) sy«_errHst ( S ) 
function erf(S) erfc(S) 
erfc(S) error function and complementary 
errprlnt(M) display 
strclean(M) STREAMS 
strerr(M) STREAMS 
log(M) Interface to STREAMS 
mkstr(C) create an 
■kstr(CF) create an 
perror(S) system 
8ya_errllst(S) •rrno(S) system 
find spelling 
■atherr(S) 
errstop(C) terminate 



connection dlal(S) 
setmnt(C) 
8etmnt(C) establish 
end(S) edata(S) 
hypot(S) 
test(C) 



entries from name list 

entries in a common object file 

entries of a COFF function Idlread(S) 

entries of a section of a COFF file 

entries of a section of a COFF file 

entries 

entry dlrent(F) 



entry getgrent(S) fgetgrent(S) 
entry getgrent(S) 



entry /f getpwent (S) endpwent(S) 

entry getpwent (S) getpwnam(S) 

entry getut(S) getutent(S) 

entry getut(S) 8etutent(S) 

entry Idgetname(S) retrieve 



entry of a COFF file Idtbindex(S) 

entry of a COFF file 

entry 

entry 

env(C) set environment for comnand 

environ(M) user environment 

environment at login time 



environment control f pgetround(S) 
environment control f pgetround(S) 
environment control f pgetround(S) 
environment control fpgetround(S) 
environment control fpgetround(S} 
environment 



environment for comnand execution 
environment name 

environment 

environment 

environment 



•rand48(S) generate pseudo-random 

arfc(S> error function and complementary 

•rt(S) erfc(S) error function and 

•rrno(S) system error messages 



nlist(S) 

linenum<F) 

Idlread(S) 

Idlseek(S) 

Idrseek ( S ) 

utmp(M) 

dirent(F) 

getgrent(S) 

getgrent(S) 

getpwent (S) 

getpwent (S) 

getut(S) 

getut(S) 

Idgetname(S) 

Idtblndex(S) 

Idtbread(S) 

putpwent (S) 

unllnk(S) 

env(C) 

environ (M) 

profile(M) 

fpgetround(S) 

fpgetround(S) 

fpgetround{S} 

f pgetround( S) 

fpgetround(S) 

environ (M) 

env<C) 

getenv(S) 

printenv(C) 

putenv(S) 

rc2(M) 

drand48(S) 

erf (S) 

erf(S) 

sya_nerr(S) 



•rror function and complementary error erf(S) 



•rror function erf(S) 
error log contents 



error logger cleanup program 

error logger daemon 

error logging 



error message file from C source 
error message file from C source 
error messages 



error messages sys_nerr(S) 
errors 



error-handling function 
error-logging demon 



erf (S) 
errprint (M) 
strclean (M) 
strerr(M) 
log(M) 
mkstr(C) 
mkstr(CP) 
perror(S) 
sys_nerr (S) 
spell (C) 
matherr (S) 
errstop(C) 
errprint (M) 



errprint (M) display error log contents 
errstop(C) terminate error-logging demon_ errstop(C) 

establish 9n out-going terminal line dlal(S) 

establish /etc/mnttab table setmniiC) 

_ aetmiit (C) 

end(S) 
_ hypot (S) 
test(C) 



/etc/mnttab table 



etext(S) last locations in program 

Euclidean distance function 

evaluate an expression 
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expr(C) 

file exec(S) execvp(S) execlp(S) 
execute a (lie exec(S) execvp(S) 
execvp(S) execlp(S) execle(S) execv(S) 
execv(S) execl(S) execute a file 

execseg(S) make a data region 
execlp(S) execle(S) execv(S) execl(S) 
regex(S) 
aetpgrp(C) 
uux(C) 
at(C) batch(C) 
cron(C) 

xargs(C) construct and 
uuxqt (N) 

inir(M) clean the file system and 
env(C) set environment for command 
nap(S) suspend 
sleep(C) suspend 
•leep(S) suspend 
monitor (S) prepare 
profll(S) 

execl(S) execute a file exec(S) 
exec(S) execvp(S) execlp(S) execle(S) 
creat(S) create a new file or rewrite an 
fal3e(C) return with a nonzero 
true(C) return with a zero 

paclc(C) pcat(C) unpack(C) compress and 
functions exp(S) pow(S) log(S) 
functions exp(S) sqrt(S) 
expression 
regexp(S) compile regular 
regexp(F) regular 
file for pattern using full regular 
expr(C) evaluate arguments as an 
regcmp(S) compile a regular 
regex(S) execute a regular 
test(C) evaluate an 
regcmp(CP) compile regular 
logarithm, and power functions 
and square root functions 
xstr(CF) 

value functions floor(S) cell(S) 
report inter-process cosaaunication 
help(C) systen help 
f actor (C) 

value 
ff (M) 
flnc(M) 

malloc(S) free(S) realloc(S) 
mallinfo(S) mallopt(S) calloc(S) 
abort (S) generate an lOT 
stream 



evaluate arguments as an expression 

ex(C) invoke a text editor 

execle(S) execv(S) execl(S) execute a 
execlp(S) execle(S) execv(S) execl(S) 
execl(S) execute a file exec(S) 



exec(S) execvp(S) execlp(S) execle(S) 

execseg(S) make a data region executable 

executable 

execute a file exec(S) execvp(S) 

execute a regular expression 



execute command in a new process group 

execute command on remote UNIX 

execute commands at a later time 

execute commands at specified times 

execute commands 



execute remote comnand requests 

executes Init 

execution 



execution for a short Interval 

execution for an interval 

execution for Interval 

execution profile 

execution time profile 



execvp(S) execlp(S) execle(S) execv(S) 

execv(S) execl(S) execute a file 

existing one 

exit value 

exit value 



exit(S) terminate process 
expand files 



exponential, logarithm, and power 

exponential, logarithm, and square root 

•l9r(C) evaluate arguments as an 

•xpression and match routines 



Mpression compile and match routines 

expression egrep(C) search 

expression 

expression 

expression 

expression 

expressions 



exp(S) pow(S) log(S) exponential. 

exp(S) 8qrt(S) exponential, logarithm. 

extract strings from C programs 

fabs(S) floor, ceiling, and absolute 

facilities status ipcs(C) 

facility 

(actor a number 

factor(C) factor a number 

false(C) return with a nonzero exit 

fast find 

fast incremental backup 

fast main memory allocator 

fast main memory allocator malloc(S) _ 

fault 

fclose(S) fflush(S) close or flush a _ 
(cntl(F) file control options 



expr(C) 
ex(C) 
exec ( S ) 
exec ( S ) 
exec ( S ) 
exec ( S ) 
execseg(S) 
execseg(S) 
exec(S) 
regex(S) 
setpgrp(C) 
uux(C) 
at(C) 
cron(C) 
xargs(C) 
uuxqt (M) 
Inlr(M) 
env(C) 
nap(S) 
sleep (C) 
_ sleep(S) 
monitor (S) 
prof 11 (S) 
exec(S) 
exec(S) 
creat(S) 
(alse(C) 
true(C) 
exit(S) 
pack(C) 
exp(S) 
exp(S) 
expr(C) 
regexp(S) 
regexp(F) 
egrep(C) 
expr(C) 
regcmp(S) 
regex(S) 
_ test(C) 

regcmp(CP) 
. exp(S) 
exp(S) 
_ xstr(CP) 
floor(S) 
_ ipcs(C) 
_ help(C) 

factor(C) 
_ factor (C) 
_ false(C) 
_ ff(M) 
_ flnc(M) 

malloc(S) 
_ malloc(S) 
_ abort(S) 
_ fclose(S) 
fcntl(F) 
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nliat(S) get 
linenuiii(F) line number 
Idliteiii(S) manipulate line number 
Idlseek(S) seek to line number 
Idrseek(S) seek to relocation 
utnip(M) wtmp(M) format of utmp and wtmp 
file system independent directory 
endgrent(S) setgrent(S) get group file 
getgrnam(S) getgrgld(S) get group file 
setpHent(S) get password file 
getpvnild(S) get password file 
utmpname(S) endutent(S) access utmp file 
getutline(S) access utmp file 
symbol name for COFF symbol table 
compute the index of a symbol table 
Idtbread(S) read an indexed symbol table 
putpwent(S) write password file 
unlink (S) remove directory 
execution 

profile (M) set up 
fpgetmask(S) IEEE floating point 
fpgetsticky(S) IEEE floating point 
fpsetmask(S) IEEE floating point 
f psetround(S) IEEE floating point 
fpsetstieky (S) IEEE floating point 
environ(M) user 
env(C) set 
getenv(S) return value for 
printenv(C) print out the 
putenv(S) change or add value to 
rc2(H) commands for multi-user 
numbers drand48(S) 
error function mrtlS) 
complementary error function 
sys_nerr(S) sys_errliat (S) 
function erf(S) erfc(S) 
erfc(S) error function and complementary 
errprint(M) display 
strclean(H) STREAMS 
strerr(M) STREAMS 
log(M) Interface to STREAMS 
mkatrCC) create an 
■katr(CP) create an 
per ror ( S ) sys t em 
8y«_errliat(S) errnoCS) system 
find spelling 
>atherr(S) 
erratop(C) terminate 



connection dlaX(S) 
setmnt(C) 
setmnt(C) establish 
end(S) edata(S) 
hypot(S) 
test(C) 



entries from name list 
entriea in a coanon obje 



:t file 



entriea of a COFF function Idlread(S) 

entries of a section of a COFF file 

entries of a section of a COFF file 

entriea 

entry dirent(F) 

entry getgrent(S) fgetgrent(S) 

entry getgrent(S) 



entry /f getpwent (S) endpwent(S) _ 

entry getpwent (S) getpwnam(S) 

entry getut(S) getutent(S) 

entry getut(S) setutent(S) 

entry Idgetname(S) retrieve 

entry of a COFF file Idtbindex(S) 

entry of a COFF file 

entry 

entry 



env(C) set environment for conmand 

envlron(M) user environment 

environment at login time 



environment control fpgetround(S) 
environment control fpgetround(S) 
environment control fpgetround(S) 
environment control fpgetround(S) 
environment control fpgetround(S) 
environment 



environment for command execution 
environment name 

environment 

environment 

environment 



•rand48(S) generate pseudo-randon 

•irtc(S) error function and complementary 

•rf(S) erfc(S) error function and 

•rrno(S) system error messages 



•rror function and complementary error 

•rror function erf(S) 

•rror log contents 



•rror logger cleanup program 

error logger daemon 

error logging 



error meaaage file from C source 
error meaaage file from C source 
error messagea 



error meaaagea aya_nerr(S) 
errora 



error-handling function 
error-logging demon 



errprlnt(N) display error log contenta _ 
erratop(C) terminate error-logging demon_ 

eatabllsh an out-going terminal line 

eatabliah /etc/mnttab table 

/etc/mnttab table 



etext(S) laat locationa in program 

Euclidean distance function 

evaluate an expression 



nlist(S) 
linenum( F) 
ldlread{S) 
Idlseek(S) 
Idrseek(S) 
utmp(M) 
dlrent(F) 
getgrent (S) 
getgrent (S) 
getpwent (S) 
getpwent (S ) 
getut(S) 
getut(S) 
Idgetname(S) 
Idtbindex(S) 
Idtbread(S) 
putpwent (S) 
unlink (S) 
env(C) 
environ (M) 
profile(M) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
environ (M) 
env(C) 
getenv(S) 
prlntenv(C) 
putenv(S) 
rc2(M) 
drand48(S) 
erf (S) 
erf(S) 
sys_nerr(S) 
erf(S) 
erf (S) 
errprint(M) 
strclean(H) 
atrerr(M) 
. log(M) 
mkstr(C) 
mkstr(CP) 
perror(S) 
sy8_nerr(S) 
spell (C) 
matherr(S) 
errstop(C) 
errprint(M) 
errstop(C) 
dial(S) 
setmiii iC) 
setniiic (C) 
end(S) 
hypot (S) 
test(C) 
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expr(C) 

file exec(S) execvp(S) execlp(S) 
execute a file exec(S) execvp(S) 
execvp(S) execlp(S) execle(S) execv(S) 
execv(S) execl(S) execute a file 

execseg(S) make a data region 
execlp(S) execle(S) execv(S) execl(S) 
regex(S) 
setpgrp(C) 
uux(C) 
at(C) batch(C) 
cron(C) 

xargs(C) construct and 
uuxqt (M) 

inir(M) clean the file system and 
env(C) set environment for command 
nap(S) suspend 
sleep(C) suspend 
sleep(S) suspend 
monitor (S) prepare 
profll(S) 

execl(S) execute a file exec(S) 
exec(S) execvp(S) execlp(S) execle(S) 
creat(S) create a new file or rewrite an 
false(C) return with a nonzero 
true(C) return with a zero 

pack(C) pcat(C) unpack (C) compress and 
functions exp(S) pow(S) log(S) 
functions exp(S) sqrt(S) 
expreaalon 
regexp(S) compile rttgular 
regexp(F) rsgular 
file for pattern using full regular 
expr(C) evaluate arguments aa an 
regcmp(S) compile a regular 
regex(S) execute a regular 
test(C) evaluate an 
regcmp(CP) compile regular 
logarithm, and power functions 
and square root functions 
xatr(CP) 

value tunctlona tloor(S) cell(S) 
report Inter-proceaa coanunlcation 
help(C) aystem help 
tactor(C) 

value 
ff (M) 
finc(M) 

malloc(S) free(S) realloc(S) 
malllnfo(S) mallopt(S) calloc(S) 
abort (S) generate an lOT 
atream 



evaluate arguments as an expression 

ex(C) invoke a text editor 

execle(S) execv(S) execl(S) execute a 
execlp(S) execle(S) execv(S) execl(S) 
execl(S) execute a file exec(S) 



exec(S) execvp(S) execlp(S) execle(S) 

execseg(S) make a data region executable 

executable 

execute a file exec(S) execvp(S) 

execute a regular expression 



execute command in a new process group 

execute comnand on remote UNIX 

execute commands at a later time 

execute commands at specified times 

execute commands 



execute remote command requests 

executes init ■ 

execution 



execution for a short interval 

execution for an interval 

execution for Interval 

execution profile 

execution time profile 



expr(C) 

ex(C) 

exec ( S ) 

exec ( S ) 

exec ( S ) 

exec ( S ) 

execseg(S) 

execseg<S) 

exec(S) 

regex(S) 

setpgrp(C) 

uux(C) 

at(C) 

cron(C) 

xargs(C) 

uuxqt (M) 

inir(M) 

env(C) 

. nap(S) 
sleep(C) 
sleep(S) 
monitor (S) 

. prof 11 (S) 



execvp(S) execlp(S) execle(S) execv(S) exec(S) 

execv(S) execl(S) execute a file 

existing one 

exit value 

exit value 



exlt(S) terminate process 
expand files 



exponential, logarithm, and power 



exec ( S ) 
creat(S) 
false(C) 
true(C) 
exit(S) 
pack(C) 
exp(S) 



exponential, logarithm, and square root _ exp(S) 



•xpr(C) evaluate arguments as an 
•xpresslon and match routines 



a«preaalon compile and match routines 

expression agrep(C> search 

expreaaion 

expreaslon 

expression 

expression 

expressions 



exp(S) pow(S) log(S) exponential. 



expr(C) 

regexp(S) 

regexp(F) 

egrep(C) 

expr(C) 

regcmp ( S ) 

regex(S) 

test(C) 

regcmp (CP) 

exp(S) 



exp(S) sqrt(S) exponential, logarithm, exp(S) 



extract strings from C programs 

fabs(S) floor, celling, and absolute 

facilities statua ipcs(C) 

facility 



factor a number 

factor (C) factor a number 

false (C) return with a nonzero exit 
fast find 



faat Incremental backup 

fast main memory allocator 

faat main memory allocator mBlloc(S) 

fault 

fcloae(S) ffluah(S) cloae or flush a 
fcntl(F) file control options 



xstr(CP) 
floor (S) 
ipcs(C) 
help(C) 
factor(C) 
factor (C) 
false(C) 
ff(M) 
finc(M) 
malloc(S) 
malloc(S) 
. abort (S) 
fclose(S) 
fcntl(F) 
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UNIX DOS disk partition* 

topen(S) 

intro(M) introduce miscellaneous 
terror (S) flleno(S) clearerr(S) 
stream status inquiries 
functions dbm(S) dbmlnit(S) 
dbm(S) flrstkey(S) store(S) 
head(C) print the first 
fclose(S) 

word from a stream getc(S) oetw(S} 
group file entry getgrent(S) 
password file entry getpwent(S) 
gets(S) 
string 
utlme(S) set 
Idfcn(F) common object 
access (S) determine accessibility of a 
acct{M) format of per-process accounting 
cplo(C) copy 
tra(C) copy out a 
chmod(S) change mode of 
chown(S) change owner and group of a 
mcs(CP) manipulate the object 
fcntl(S) 
fcntl(F) 

uupick(C) public UNIX-to-UNIX system 
core(F) format of core image 
cprs(CP) comprease a common object 
umaskCS) set and get 
ctaga(C) create a tags 
dd(C) convert and copy a 
delta(CP) make a change to an SCCS 
cl08e(S) close a 
dup(S) dup2(S) duplicate an open 
dump selected parts of an object 
sact(CP) print current SCCS 
crypt (S) password and 
endgrent(S) setgrent(S) get group 
getgrnam(S) getgrgld(S) get group 
endpwent(S) setpwent(S) get password 
getpwnam(S) getpHuld(S) get password 
utmpname(S) endutent(S) access utmp 
setutent(S) g«tutllne(S) access utmp 
putp««nt(S) write password 
execle(S) execv(S) exacl(S) execute a 
fgrep(C) search a 
grep(C) search a 
expression egrep(C) search 
Idaopen(S) open a common object 
ar(F) archive 
xar(F) archive 
intro(F) introduction to 
mkstr(C) create an error message 
mkstr(CP) create an error message 



fcntl(S) file control 

fcopy(C) copy a floppy diskette 
tdisk(C) 



fdopen(S) freopen(S) open a stream 
features and files 



feof(S) stream status inquiries 

f error (S) flleno(S) clearerr(S) feof(S) 

fetch(S) nextkey(S) perform database 

fetch(S) perform database functions 

few lines of a stream 



fflush(S) close or flush a stream 
ff(M) fast find 



fgetc(S) getchar(S) get character or 

fgetgrent(S) endgrent(S) setgrent(S) get 
fgetpwent(S) endpwent(S) setpwent(S) get 

fgeta(S) get a string from a stream 

fgrep(C) search a file for a character fgrcp(C) 



fcntl(S) 
fcopy(C) 
fdlsk(C) 
f open ( S ) 
intro(M) 
ferror(S) 
ferror(S) 
dbm(S) 
dbm(S) 
head(C) 
fclose(S) 
ft<M) 
getc(S) 
getgrent (S) 
getpwent(S) 
gets(S) 



file access and modification times 

tile access routines 

file 

file 

file archives in and out 

file as it grows 

file 

file 



tile comment section 
file control 



file control options 

file copy uuto(C) 

file 

file 



file creation mask 

flX« 

fil« 

file 



file descriptor 

file descriptor 

file dump (CP) 

file edit activity 

file encryption functions 

file entry getgrent (S) fgetgrent(S) 
file entry getgrent (S) 



file entry getpwent(S) fgetpwent(S) 
file entry getpwent(S) 



file entry getut(S) getutent(S) 

file entry getut(S) 

file entry 



file exec(S) exacvp(S) execlp(S) 

file for a character string 

file for a pattern 



file for pattern using full regular 

tile for reading Idopen(S) 

tile format 

file format 

file formats 

file from C source 

file from C source 



utime(S) 
Idtcn(F) 
access (S) 
acct(M) 
cpio(C) 
tra(C) 
chmod(S) 
chown(S) 
mcs(CP) 
fcntl(S) 
fcntl(P) 
uuto(C) 
core(F) 
cprs(CP) 
umask(S) 
ctags(C) 
dd(C) 
delta(CP) 
close (S) 
dup(S) 
dump (CP) 
sact(CP) 
crypt(S) 
getgrent (S) 
getgrent (S) 
getpwent(S) 
getpwent(S) 
getut(S) 
getut(S) 
putpwent(S) 
exec ( S ) 
tgrep(C) 
grep(C) 
egrep(C) 
Idopen(S) 
. ar(F) 
xar(F) 
Intro(F) 
mkstr(C) 
mkstr(CP) 
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fixobj(CP) convert an object file 

get (CP) get a weriion of an SCCS file 

read directory entries and put in a tile 

group(M) format of the group file 

display selected parts of an object file 

filehdr(F) file 

constants limits(F) file 

unistd(F) file 

Idfhread(S) read the file 

Idohseek(S) seek to the optional file 

aplit(C) split a file 

archive header of a member of an archive file 

Idclose(S) Idaclose(S) close a COFF file 

read the file header of a COFF fil 

number entries of a section of a COFF file 

entries of a section of a COFF file 

Indexed/named section header of a COFF file 

index of a symbol table entry of a COFF tile 

an indexed symbol table entry of a COFF tile 

seek to the symbol table of a COFF file 

line number entries in a common object file 

llnk(S) link to a file 

produce C source listing from COFF til 

ln(C) make a link to a file 

mem(M) kmem(M) memory image file 

convert object file to bootable object tile 

a directory, or a special or ordinary file 

ctermid(S) generate tile 

mktemp(S) make a unique file 

nl(C) add line numbers to a tile 

nm(CP) print name list of common object file 

null(M) null file 

ttyslot(S) find the slot in the utmp file 

more(C} view a tile 

chmod(C) Changs permissions of a tile 

fuser(M) identify processes using a file 

cre«t(S) create a new file 

passwd(N) password file 

for CRTs file 

fseek(S) ftell(S) rewind(S) reposition a tile 

Iseek(S) move read/write tile 

printers (N) print spooler configuration file 

prs(CP) print an SCCS file 

pwck(M) grpck(H) check password/group file 

read(S) read from tile 

locking(S) lock/unlock a file 

of information for a conanon object tile 

rev(C) reverse lines of a file 

rmdel(CP) remove a delta from an SCCS file 

compare two versions of an SCCS file 

sccsflle<F) format of an SCCS file 

section header for a coamon object file 

format of curses screen image file 

8ee(C) display a file 

ch«ize(S) change the file 

stat(S) f8tat(S) get file 

find the printable strings in an object file 



from OMF to COFF 



getdents(S) 



hdr(C) 

header for common object files 

header tor implementation-specific 

header tor symbolic constants 

header of a COFF file 



header of a common object 
into pieces 



Idahread(S) read the 



e Idfhread(S) 



Idlseek(S) seek to line 
Idrseek(S) seek to reloc 

Idshread(S) read an 

Idtbindex(S) compute the 

Idtbread(S) read 

Idtbseek(S) 

linenum(F) 



e list(CP) 



mknod(S) make 

name for terminal 
name 



of the current user 
one full screen at a 

or directory 

or tile structure 



or rewrite an existing one 



perusal filter 

pointer in a stream 
pointer 



region tor read/write 
reloc (F) relocation 



sccsdltf (CP) 



scr_dump ( F ) 



f ixobj (CP) 
get (CP) 
getdents(S) 
group (M) 
hdr(C) 
tilehdr(F) 
limits(F) 
unistd(F) 
Idfhread(S) 
Idohaeek(S) 
split (C) 
Idahread(S) 
Idclose(S) 
Idfhread(S) 
Idlseek(S) 
Idrseek(S) 
Idshread(S) 
Idtbindex(S) 
Idtbread(S) 
Idtbseek(S) 
linenum(F) 
link(S) 
list(CP) 
ln(C) 
mera(M) 
mkboot (M) 
mknod ( S ) 
ctermid(S) 
mkt emp( S ] 
nl(C) 
nm(CP) 
nulKM) 
ttyalot(S) 
more (C) 
chmod(C) 
fuser(Mj 
creat(S) 
passwd(M) 
. PO(C) 
fseek(S) 
Iseek(S) 
printer3(M) 
_ prs(CP) 
pwck(M) 
read(S) 
lockingO) 
reloc (F) 
rev(C) 
rmdel(CP) 
sccsdiff(CP) 
sccsfile(F) 
scnhdr(F) 
scr i.-.'.plF) 



stat(S) 
strings(C) 



PI-18 



Permuted Index 



symbola and line numbers from COFF 
identity processes using a file or 

mount (C) amount (C) mount /unmount a 
calculate checksum and count blocks in a 
syms(F) comnon object 
Inlr(M) clean the 
ckbupscd(M) check 
fsdb(H) 

recover(C) restore contents of a 
fslnfo(M) report information about a 
fstyp(M) determine the 
dirent(F) 
statfs(S) fatatfs(S) get 
mkf8(M) construct a 
mount (S) mount a 
quot(C) aumnarize 
ustat(S) get 
fsstat(M) report 
fstab(M) 
mnttab(M} mounted 
archive (C) save a 
sysfsCS) get 
volcopy(M) labelit(M) copy 
haltsys(C) close the 
fsck(C) dfsck(C) check and repair 
labelit(C) provide labels for 
umountall(C) mount /unmount multiple 
checklist (M) list 
tall(C) deliver the last part of a 
tmpfile(S) create a temporary 
teinpnam(S) create a name for a temporary 
mkboot(M) convert object 
tsort(C) sort a 
access and modification times of a 
uuclco(H) 

uu8ched(M) scheduler for the uucp 
ftH(S) walk a 
ttyB(M) login terminals 
flle(C) determine 
unget(CP) undo a previous get of an SCCS 
uniq(C) report repeated lines in a 
the uucp directories and permissions 
val(CP) validate an SCCS 
mkunlx(M) make bootable system 
mkunlx(H) make bootable system 
write(S) write on a 

umask(C) set 
files 

status inquiries ferror(S) 
csplit(C) split 
admin(CP) create and administer SCCS 
llnk(H) unlink(M) link and unlink 
mv(C) move (rename) 
aftp(C) transfer 
bfs(C) scan big 
cat(C) concatenate and display 



file strip(CP) remove _ 
file structure fuser(M) 

file structure 

file sum(C) 



file symbol table format 

file system and executes init 

file system backup schedule 

file system debugger 

file system from tape 

file system 

file system identifier 



file system independent directory entry 

file system Information 

file system 

file system 

file system otmershlp 

file system statistics 

file system status 

file system table 

file system table 



file system to a streaming tape 

file system type information 

file system with label checking 

file systems and halt the CPU 

file systems 

file systems 



file systems mountall(C) 

file systems processed by fsck 

file 

file 



file tmpnam(S) 

file to bootable object file 

file topologlcally 

file touch (C) update 

file transport program for uucp system 

file transport program 

file tree 

file 

file type 

file 

file 



file uucheck(H) check 
file 



file with driver symbol table 
file with kernel symbol table 
file 



file(C) determine file type 
file-creation mode mask 



fllehdr(F) file header for conmon object 

flleno(S) clearerr(S) feof(S) stream 

files according to context 

files 

files and directories 

files and directories 

files between Altos machines 

files 

files 



strip(CP) 

fuser(M) 

mount (C) 

sum(C) 

syms(F) 

inir(M) 

ckbupscd(M) 

fsdb(M) 

recover (C) 

fsinfo(M) 

fstyp(M) 

dirent(F) 

8tatfs(S) 

mkfB(M) 

mount (S) 

quot(C) 

ustat(S) 

fastat(M) 

fstab(M) 

mnttab(M) 

archive (C) 

sysfs(S) 

volcopy(M) 

haltsys(C) 

fsck(C) 

labellt(C) 

mountalKC) 

checklist (M) 

tail(C) 

tmpfile(S) 

tmpnam(S) 

mkboot(N) 

tsort(C) 

touch (C) 

uuclco(M) 

uusched(M) 

ftw(S) 

ttys(M) 

flle(C) 

unget(CP) 

unlq(C) 

uucheck (M) 

val(CP) 

mkunix(H) 

mkunlx(M) 

write (S) 

file(C) 

umask(C) 

filehdr(F) 

f error (S) 

csplit(C) 

admin (CP) 

llnk(M) 

. mv(C) 

. aftp(C) 

. bfs(C) 
cat(C) 
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cmp(C) compare two 
select /reject lines conmon to two sorted 
conw(CP) convert common object 
copy(C) copy groups of 
cp(C) copy 

crontab(C) manage user crontab 
dlff3(C) compare three 
diff(C) compare two text 
dos(C) access MS-DOS 
filehdr(F) file header for common object 
find(C) find 
hplp(C) hplpR(C) filter 
frec(M) recover 
uucp(C) uulog(C) uuname(C) copy 
fspec(F) format specification in text 
f split (CP) split ratfor 
hd(C) display 
fleece (C) look for 
od(C) display 
introduce miacellaneous features and 
lockf(S) record locking on 
makedevs(M) create special device 
n)aketty8(M) create tty special 
mknod(C) build special 
pr(C) print 
rm(C) rmdir(C) remove 
pcat(C) unpack(C) compress and expand 
devnm(C) identify device name on which 
the access and modification dates of 
sdiff(C) compare 
print section sizes of comnon object 
sort(C) sort and merge 
tar(C) archive 
Ipr(C) route named 
bdiff(C) compare 
what(C) identify 
fxlist(S) get name list entries from 



printer hplp(C) hplpR(C) 



files comm(C) 
files 



ft(H) fast 
tind(C) 
finger (C) 
look(C) 
ttynaM(S) i«atty(S) 
library lorder(CP) 
tile strings (C) 
current user ttyslot(S) 



fold(C) fold long lines for 
database functions dbm(S) 
OMF to COFF 
directories 
fpgetround(S) fpgetmask(S) IEEE 
fpgetround(S) fpgetsticky(S) IEEE 



files 

files 

files 

files 

files 

files 

files 

files 

files for printing on LaserJet printer 

files from a back-up tape 

files from UNIX to UNIX 

files 

files 

files in hexadecimal format 

files in home directories 

files in octal format 

files intro(M) 

files 

files 

files 

tiles 



files on the standard output 

files or directories 

files pack(C) 

files reside 



files settime(C) change 

files side-by-side 

files size(C) 

files 

tiles 



tiles to printer spooler 
files too large for diff 
tiles 



tiles xlist(S) 

f ilesystem(M) format of a system volume 
filter tile tor CRT 



filter tiles tor printing on LaserJet 

finc(M) fast incremental backup 

find 

find tiles 

find information about users 

find lines in a sorted list 

find name of a terminal 



find ordering relation tor object 

find the printable strings in an object 

find the slot in the utmp tile of the 

find(C) find files 



tinger(Cl find information about users 
finite width output device 



tirstkey(S) store (S) tetch(S) perform 
fixobj(CP) convert an object file from 

fleece (C) look for tiles in hooie 

floating point environment control 

floating point environment control 



cmp(C) 
coniti(C) 
conv ( CP ) 
copy(C) 
cp(C) 

crontab(C) 

diff3(C) 

diff (C) 

dos(C) 

filehdr(F) 

find(C) 

hplp(C) 

frec(M) 

uucp(C) 

fspec(F) 

f split (CP) 

hd(C) 

fleece(C) 
, od(C) 

intro(M) 

lockf(S) 

makedevs(M) 

makettys(M) 

mknod(C) 
. pr(C) 

rm(C) 
. pack(C) 

devnm(C) 

settime(C) 
. sdiff (C) 

size(C) 

3ort(C) 
. tar(C) 
. Ipr(C) 
. bditf(C) 
. what(C) 
. xlist(S) 

tilesyst 
. PO(C) 
. hplp(C) 

tinc(M) 
. tt(M) 

tind(C) 

finger (C) 

look(C) 

ttyname(S) 
. lorder(CP) 

strings (C) 

ttyslot(S) 

find(C) 

finger(C) 

fold(C) 
. dbm(S) 

fixobj(CP) 

fleece(C) 

fpgetround(S 

fpgetround(S 



(M) 
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fpgetround(S) fpaetmaskCS) IEEE 
fpgetround(S) fpBetround(S) IEEE 
f pgetround(S) fp»etsticlcy(S) IEEE 
isnan(S) isnanf(S) isnand(S) test for 
ecvt(S) convert 
modf(S) Idexp(S) manipulate parts oC 
functions floor(S) ceil(S) fabs(S) 
functions floor(S) fmod(S) 
and absolute value functions 
absolute value functions 
opt ions <M) 
fcopy(C) copy a 
format (C) format a 
cflow(CP) generate C 
fclose(S) fflush(S) close or 
value functions floor(S) 

device fold(C) 
output device 
stream 

format (C) 
ar(F) archive file 
hd(C) display files in hexadecimal 
od(C) display files in octal 
dir(M) 
fileaystem(M) 
inode(M) 
accsf ile(F) 
output a.out(F) 
menus (M) 
core(F) 
cpio(F> 
scr_dump(F) 
acct(M) 
group (M) 
utmp(M) wtinp(M) 
fspec(F) 

syms(F) common object file symbol table 
xar(F) archive file 

intro(F) introduction to tile 
scanf(S) fscanf(S) sscanf(S) convert 
vprintf(S) vfprintf(S) vsprlntf(S) print 
printf(S) sprintf(S) fprintf(S) print 
tiiit(C) simple text 
convert rational FORTRAN to standard 
ratfor(CP) convert rational 
environment control fpgetround(S) 
point environment control 
floating point environment control 
point environment control 
floating point environment control 
floating point environment control 
environment control fpgetround(S) 
printf(S) sprintf(S) 
environment control fpgetround(S) 



floating point environment control 
floating point environment control 
floating point environment control 
floating point NaN 



floating-point number to string 

floating-point numbers frexp(S) 

floor, ceiling, and absolute value 

floor, ceiling, and absolute value 

floor(S) ceil(S) fabs(S) floor, ceiling, 

floor(S) fmod(S) floor, ceiling, and 

floppy disk installation menu 

floppy diskette 

floppy diskette 

flow graph 

flush a stream 



fmod(S) floor, ceiling, and absolute 

tmt(C) simple text formatter 

fold long lines for finite width output 
fold(C) fold long lines for finite width 
fopen(S) fdopen(S) freopen(S) open a _ 

fork(S) create a new process 

format a floppy diskette 

format 

format 

format 

format of a directory 

format of a system volume 

format of an inode 



format of an SCCS file 

format of assembler and link editor 
format of Business Shell menu system 

format of core image file 

format of epic archive 

format of curses scr 



image file 



format of per-process accounting file 
format of the group file 



format of utmp and wtmp entries 

format specification in text files 

format 

format 



format (C) format a floppy diskette 
formats 



formatted input 

formatted output of varargs list 

formatted output 

formatter 



FORTRAN rat for (CP) 

FORTRAN to standard FORTRAN 

fpgetmask(S) IEEE floating point 

fpgetround(S) fpgetmask(S) IEEE floating 
fpgetround(S) f pgetsticky (S) IEEE 



fpgetround(S) fpsetma8k(S) IEEE floating 

fpgetround(S) fpsetround(S) IEEE 

fpgetround(S) fpsetstlcky(S) IEEE 

f pgetsticky (S) IEEE floating point 

fprintf (S) print formatted output 

fpsetmask(S) IEEE floating point 



tpoetround( S ) 

tpgetround(S) 

tpgetround(S) 

isnan(S) 

ecvt ( S ) 

frexp(S) 

floor (S) 

floor (S) 

tloor(S) 

floor (S) 

options(M) 

fcopy(C) 

format (C) 

cflow(CP) 

f close (S) 

floor(S) 

fmt(C) 

fold(C) 

fold(C) 

fopen(S) 

fork(S) 

format (C) 

ar(F) 

hd(C) 

od(C) 

dir(M) 

filesystemfM) 
inode (M) 
sccsfile(F) 
a.out(F) 
menus (M) 
core(F) 

. cpio(F) 
8cr_dump(F) 
acct(M) 
group (M) 
utmp(M) 
fspec(F) 
syms(F) 
xar(F) 
format (C) 
intro(F) 
scanf(S) 
vprintf(S) 

. printf(S) 
fmt(C) 
ratfor(CP) 
rat for (CP) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpgetround(S) 
fpget round (S) 
f pyetround(S) 
printf(S) 
fpgetround(S) 
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environment control fpgetround(S) 
environment control fpgetround(S) 
stream putc(S) putchar(S) putw(S) 
puts(S) 
fwrite(S) 
tape 

df(H) report number of 
allocator malloc(S) 
fopen(S) fdopen(S) 
parts of floating-point numbers 

gencc(CP) create a 
input scanfCS) 
list file systems processed by 
systems 

file pointer in a stream 
file system 
files 



statfs(S) 
stat(S) 
identifier 
pointer in a stream faeek(S} 
communication package stdlpc(S) 

egrep(C) search file for pattern using 
more(C) view a file one 
function erf(S) erfc(S) error 
error function and complementary error 
ganma ( S ) log gamma 
hypot(S) Euclidean distance 
nanipulate line number entries of a COFF 
matherr(S) error-handling 
prof(F) profile within a 
math(F) math 
Intro(S) Introduce system calls. 
bessel(S) jO(S) yO(S) Besael 
crypt (S) password and file encryption 
fetch(S) nextkey(S) perform database 
store(S) fetch(S) perform database 
log(S) exponential, logarithm, and power 
exponential, logarltbai, and square root 
floor, ceillno. and absolute value 
floor, ceillno, *'>d absolute value 
sinh(S) cosh(S) tanh(S) hyperbolic 
trig(S) atan(S) atan2(S) trigonometric 
tan(S) asin(S) acos(S) trigonometric 
or file structure 

files xllst(S) 
gamma (S) log 

command 
adb(C) invoke x.out 



f psetround(Sl IEEE floating point 
fpsetsticky(S) IEEE floating point 
fputc(S) put character or word on 
tputs(S) put a string on a stream 
fread(S) binary input/output 
frec(M) recover files from a 
free disk blocks and inodes 
free(S) realloc(S) fast main 
freopen(S) open a stream 
frexp(S) modf(S) Idexp(S) manipul 
from(C) list who my mall is 
front end to the cc command 
fscanf(S) sacant(S) 
fsck checklist (M) 
fsck(C) dfsck(C> 




formatted 



gencc(CP) 
scanf (S) 
checklist (M) 



heck and repair file fsck(C) 

fsdb(M) tile system debugger fsdb(M) 

fseek(S) ftell(S) rewind(S) reposition a fseek(S) 

fsinfo(M) report information about a fsinfo(M) 

fspec(F) format specification in text 
tsplit(CP) split ratfor files 



fspec(F) 
f split (CP) 
f sstat (M) 
fstab(M) 

fstatfs(S) get file system information statfs(S) 



f sstat (N) report file system status 
fstab(M) file system table 



fatat(S) get file status 

fstyp(M) determine the file system 

ftell(S) rewlnd(S) reposition a file 

ftok(S) standard interprocess 

ftw(S) walk a file tree 

full regular expression 

full screen at a time 



function and complementary error 

function erf(S) erfc(S) 

function 

function 



function Idlread(S) Idllten(S) 

function 

function 



functions and constants 
functions, and libraries 

functions 

functions 



functions dbm(S) dbmlnlt(S) 
functions dbm(S) flrstkey(S) 

functions exp(S) po«(S) 

functions exp(S) sqrt(S) 



functions floor (S) celKS) fabs(S) 

functions floor (S) fmod(S) 

functions 

functions 



functions trig(S) sln(S) cob(S) 

fuser(M) Identify processes using a file 
fwrlte(S) fread(S) binary Input/output _ 

txllst(S) get name list entries from 

gamma function 



gamna(S) log gamma function 

gencc(CP) create a front end tt 
general purpose debugger 



the cc 



Stat (S) 

fstyp(M) 

fseek(S) 

atdlpc(S) 

ftw(S) 

egrep(C) 

more(C) 

erf (S) 

erf (S) 

gamma ( S ) 

hypot ( S ) 

Idlread(S) 

matherr(S) 

prof (F) 

math(F) 

intro(S) 

bessel(S) 

crypt (S) 

dbm(S) 

dbm(S) 

exp(S) 

exp(S) 

floor (S) 

floor(S) 

slnh(S) 

trig(S) 

trlgCS) 

fuser(M) 

twrite(S) 

xlist(S) 

gamma ( S ) 

gamma ( S ) 

gencc(CP) 

adb(C) 
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tennio<M} 
random (C) 
mkvers (CP) 
makekey (M) 
abort (S) 
cflow(CP) 
cxref (CP) 
cterinid(S) 
ncheck(M) 
lex (CP) 

drand48(S) erand48(S) 
/mrand48(S) nrand48(S) lrand48(S) 
/3eed48(S) Brand48(S) Jrand48(S) 
rand(S) srand(S) simple random-number 
stream getc(S) getw(S) fgetc(S) 

character or word from a stream 
working directory 
put in a file 
group IDs getuid(S) 
name 

group IDs getuid(S) 
group IDs getuid(S) 
setgrent(S) get group file entry 
group file entry 
getgrent(S) getgrnam(S) 
entry getgrent(S) 



argument vector 

and parent process IDs 
setpwent(S) get password file entry 
password file entry 
file entry getpwent(S) 

getpwent(S) getpwnam(S) 
input 
stream 

speed and terminal settings used by 
ct(C) spawn 



used by getty 



user or group IDs 
user or group IDs 
user or group IDs 
access utmp file entry getut(S) 
getut(S) setutent(S) 
endutent(S) access utmp file entry 
utmp file entry 
character or word from a stream getc(S) 
login (C) 
symbols 

time to string ctime(S) 
setjmp(S) longjmp(S) non-local 
cflow(CP) generate C flow 



general terminal Interface 

generate a random number 

generate a what string 

generate an encryption key 

generate an lOT fault 

generate C flow graph 



generate C program cross-reference 
generate file name for terminal 



tennio(M) 
random(C) 
mkvers ( CP ) 
makekey (M) 
abort (S) 
cflow(CP) 
cxref (CP) 
ctermid(S) 
ncheck(M) 



generate path names from inode numbers 
generate programs for lexical analysis lex(CP) 



generate pseudo-random numbers 
generate pseudo-random numbers 
generate pseudo-random numbers 
generator 



drand4e(S) 

drand48(S) 

drand48(S) 

rand(S) 

getchar(S) get character or word from a _ getc(S) 

get (CP) get a version of an SCCS tile get (CP) 

getc(S) getw(S) fgetc(S) getchar(S) get _ getc(S) 

getcwd(S) get path name of current getcwd(S) 

getdents(S) read directory entries and getdents(S) 



getegid(S) get real/effective user or 

getenv(S) return value for environment 

geteuid(S) get real/effective user or 

getgid(S) get real/effective user or 

getgrent(S) fgetgrent(S) endgrent(S) 

getgrent(S) getgrnain(S) getgrgld(S) get 
getgrgid(S) get group file entry 



getgrnaffl(S) getgrgid(S) get group file 
getlogln(S) get login name 



getmsg(S) get next message off a stream 

getopt(C) parse command options 

getopt(S) get option letter from 

getpas(S) read a password 

getpid(S) get process, process group. 

getpwent(S) fgetpwent(S) endpwent(S) 

getpwent(S) getpwnam(S) getpwuid(S) get 

getpwnam(S) getpwuid(S) get password 

getpw(S) get name from UID 



getpwuid(S) get password tile entry 

gets(C) get a string from the standard 

gets(S) fgets(S) get a string from a 

getty gettydefs(M) 



getty to a remote terminal 

gettydefs(M) speed and terminal settings 
getty(M) set terminal mode 



getuld(S) geteaid(S) get real/effective 
getuld(S) geteuid(S) get real/effective 
getuld(S) getgld(S) get real/effective 

getutent(S) utmpname(S) endutent(S) 

getutline(S) access utmp file entry 

getut(S) getutent(S) utmpname(S) 



getut(S) setutent(S> getutline(S) access 

getw(S) fgetc(S) getchar(S) get 

give you system access 



glossary (C) define common UNIX terms and 
gmtime(S) localtime(S) convert date and 

goto 

graph 



getuid(S) 

getenv(S) 

getuid(S) 

getuid(S) 

getgrent(S) 

getgrent(S) 

getgrent(S) 

getgrent(S) 

getlogin(S) 

getmsg ( S ) 

get opt (C) 

getopt (S) 

getpas(S) 

getpid(S) 

getpwent ( S ) 

getpwent ( S ) 

getpwent (S) 

getpw(S) 

getpwent ( S ) 

gets(C) 

gets(S) 

gettydefs(M) 

ct(C) 

gettydefs(M) 

getty(M) 

getuid(S) 

getuid(S) 

getuid(S) 

getut(S) 

getut(S) 

getut(S) 

getut(S) 

getc(S) 

login(C) 

glossary (C) 

ctime(S) 

setjmp(S) 

cflow(CP) 
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graph (C) draw a graph 



graph (C) draw a graph 



plot(S) graphics interface subroutines 



getpid(S) get process, process 
fgetgrent(S) endgrent(S) setgrent(S) get 
getgrent(S) getgrnaiii(S) getgrgid(S) get 
group(H) format of the 
id(C) print user and 
chown(C) chgrp(C) change owner or 
setpgrp(S) set process 
getegid(S) get real/effective user or 
geteuid(S) get real/effective user or 
getgid(S) get real/effective user or 
setuid(S) set user and 
newgrp(C) log user into a new 
chown(S) change owner and 
kill(S) send a signal to a process or a 
execute command in a new process 

copy(C) copy 

make(C) maintain, update, and regenerate 
tra(C) copy out a file as it 
pwck(M) 
ssignal(S) 

haltsys(C) close the file systems and 
halt the CPU 
varargs(F) 
curses (S) terminal screen 
nohup(C) run a coiimand immune to 
add.hd(C) add an additional 
restore. hd(C) restore a 
layout (M) manage 
dump.hd(C) dump contents of a 
upgrade. hd(C) upgrade an additional 
find spelling errors 
find spelling errors 
hsearch(S) hdestroy(S) hcreate(S) manage 
generate 
hsearch(S) hdestroy(S) 
format 

search tables hsearch(S) 
object file 
stream 
scnhdr(F) section 
filehdr(F) file 
constants limits (F) file 
unistd(F) file 
Idfhread(S) read the file 
read an indexed/naned section 
Idohaeek(S) seek to the optional file 
Idahread(S) read the archive 
belp(C) system 

hd(C) display files in 
fleece(C) look for files in 
printing on LaserJet printer 



grep(C) search a file for a pattern 

group, and parent process IDs 

group file entry getgrent(S) 

group file entry 

group file 



group ID and names 

group ID 

group id 



group IDs getuid(S) 
group IDs getuid(S) 
group IDs getuid(S) 

group IDs 

group 



group of a file 

group of processes 

group 8etpgrp(C) 



group(M) format of the group file 

groups of files 

groups of programs 

grows 



grpck(M) check password/group file 

gsignal(S) software signals 

halt the CPU 



haltsys(C) close the file systems and 

handles variable argument list 

handling and optimization package 

hangups and quits 

hard disk 



hard disk from tape 
hard disk partitions 

hard disk to tape 

hard disk 

hashcheck(C) 

hashnake(C) 



hash search tables 

hashing encryption 

hcreate(S) manage hash search tables 

hd(C) display files in hexadecimal 

hdestroy(S) hcreate(S) manage hash 

hdr(C) display selected parts of an 
head(C) print the first tew lines of a head(C) 



graph (C) 
graph (C) 
plot(S) 
grep(C) 
getpid(S) 
getgrent (S) 
getgrent(S) 
group (M) 
id(C) 
choimfC) 
setpgrp ( S ) 
getuld(S) 
getuid(S) 
getuid(S) 
setuid(S) 
newgrp(C) 
chown ( S ) 
kill(S) 
setpgrp (C) 
group (M) 
copy(C) 
make(C) 
tra(C) 
pwck(M) 
ssignal(S) 
haltsys(C) 
haltsys(C) 
varargs(F) 
curses (S) 
nohup(C) 
_ add.hd(C) 

restore . hd ( C) 
_ layout (M) 
dump. hd(C) 
upgrade. hd(C) 
. spell (C) 
. spell (C) 

hsearch(S) 
_ crypt (S) 

hsearch(S) 
. hd(C) 
hsearch(S) 
hdr(C) 



header for a common object file 

header for common object files 

header for implementation-specific 

header for symbolic constants 

header of a COFF file 



header of a COFF file Idshread(S) 
header of a common object 



header of a member of an archive file 
help facility 



halp(C) system help facility 

hexadecimal format 

home directories 



hplp(C) hplpR(C) filter files for 



scnhdr(F) 

rilehdr(F) 

limits(F) 

uni8td(F) 

Idfhread(S) 

Idshread(S) 

Idohseek(S) 

Idahread ( S ) 

help(C) 

help(C) 

hd(C) 

fleece(C) 

hplp(C) 
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LaserJet printer hplp(C) 
hash search tables 
sinh(S) cosh(S) tanh(S) 

id(C) print user and group 
chown(C) charp(C) change ovmer or group 
queue, semphore set, shared memory 
setpgrp(S) set process group 
whoami(C) print effective current user 

fstyp(M) determine the file system 
shmget(S) get shared memory segment 
reside devnm(C) 
what(C) 
structure fuser(M) 
process group, and parent process 
get real/effective user or group 
get real/effective user or group 
get real/effective user or group 
setuid(S) set user and group 
fpgetround(S) fpgetmask(S) 
fpgetround(S) fpgetsticky(S) 
fpgetround(S) fpsetmask(S) 
fpgetround(S) f psetround(S) 
fpgetround(S) fpsetsticky (S) 
core(F) format of core 
mem(M) kmem(M) memory 
scr_duinp(F) format of curses screen 
nohup(C) run a command 
limlts(F) file header for 
fine CM) fast 
dirent(F) file system 
file Idtbindex(S) compute the 
file Idtbread(S) read an 
file Idshread(S) read an 
descriptions 
fsinfo(M) report 
finger (C) find 
devinfo(C) display device 
default (M) default program 
reloc(F) relocation of 
Ipatat(C) print LP status 
statfs(S) fstatfs(S) get file system 
sysconf(C) get system configuration 
sysconf(S) get system configuration 
sysfs(S) get file system type 
uname(C) print the current UNIX 
drive (C) drive 
executes inlt 
clean the file system and executes 
inittab(M) script for the 
special login program invoked by 
init(H) process control 
brc (M) system 
popen(S) pclose(S) 



hplpR(C) filter files for printing on 

hsearch(Sl hdestroy(S) hcreate(S) manage 
hyperbolic functions 



hypot(S) Euclidean distance function 
ID and names 



id 

id(C) print user and group ID and names 

identifier 

identifier 

identify device name on which tiles 

identify files 



identify processes using a file or C 

IDs getpid(S) get process, 

IDs getuid(S) getegid(S) 

IDs getuid(S) geteuid(S) 

IDs getuid(S) getgid(S) 

IDs 

IEEE floating point environment control _ fpgetround(S) 
IEEE floating point environment control _ fpgetround(S) 
IEEE floating point environment control _ fpgetround(S) 
IEEE floating point environment control _ fpgetround(S) 



hplp(C) 
hsearch(S) 
sinh(S) 
hypot(S) 
id(C) 
chown ( C ) 
ipcrni(C) 
setpgrp(S) 
whoami ( C ) 
id(C) 
tstYp(M) 
shmget(S) 
devnm<C) 
what(C) 
fu8er(M) 
getpid(S) 
getuid(S) 
getuid(S) 
getuid(S) 
setuid(S) 



IEEE floating point environment contr 

image file 

image file 

image file 



immune to hangups and quits 

implementation-specific constants 
incremental backup 



independent directory entry 

index of a symbol table entry of a COFF 

indexed symbol table entry of a COFF 

indexed/named section header of a COFF 

infocmp(M) compare or print terminfo 

information about a file system 

information about users 

information 



information directory 

information for a common object file 

information 

information 

information 

information 

information 

information 



information written during manufacturing 

inir(M) clean the file system and 

init inir(M) 

init processes 

init sulogln(H) 

Initialization 



fpgetround(S) 
core(F) 
meffl(M) 
scrdump ( F ) 
nohup(C) 
limits(F) 
finc(M) 
dirent(F) 
Idtbindex(S) 
Idtbread(S) 
Idshread(S) 
inf ocmp (M) 
fainfo(M) 
finger (C) 
devinfo(C) 
default (M) 
reloc(F) 
Ipstat(C) 
statfs(S) 
sysconf (C) 
sysconf (S) 
sysfs(S) 
uname(C) 
drive (C) 
inir(M) 
inir(M) 
inittab(M) 
sulogin(M) 
init(M) 
brciM) 
popen(S) 



initialization procedure 

initiate pipe to/from a process 

init(M) process control initialization init(M) 

inittab(M) script for the init processes inittab(M) 
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clridl) clear 
inode(M) format of an 
ncheck(M) generate path names from 

report niimber of free disk blocks and 
gets(C) get a string from the standard 
llne(C) read one line of 
fscanf(S) sacanf(S) convert formatted 
ungetc(S) push character back Into 
fwrlte(S) fread(S) binary 
poll(S) STREAMS 
atdio(S) standard buffered 
clearerr(S) teof(S) stream status 
uu8tat(C) UUCP status 
install(M) 
cpset(C) 
options(M) floppy disk 

abs(S) return 
a641(S) 164a(S) convert between long 
sputl(S) sgetl(S) access long 
atoKS) atoi(S) convert string to 
13tol(S) ltol3(S) convert between 3-byte 
convert between B-byte integers and long 
plot(S) graphics 
termio(M) general terminal 
log(M) 
spline(C) 
characters asa(C) 
sh(C} rsh(C} invoke the shell command 
csh(C) shell conmand 
pipe(S) create an 
status ipcs(C) report 
stdipc(S) ftok(S) standard 
nap(S) suspend execution for a short 
sleep (C) suspend execution for an 
sleep (S) suspend execution for 

coomands 

intro(C) 
files intro(M) 
intro(CP) 
libraries Intro(S) 
intro(F) 

features and tiles 
functions, and libraries 

yacc(CP) 
m4(CP) 
calendar(C) 
vi(C) 
ex(C) 
bsh(C) 
cc(CP) 
ed(C) red(C) 
edit(C) 
Id(CP) 



Inode 

inode 

inode numbers 

inode (M) format of an inode 

inodes df(M) 

input 

input 

input scanf(S) 

input stream 

input /output 

input /output multiplexing 

input/output package 

nquiries ferror(S) fileno(S) 

inquiry and job control 

nstall commands 

nstall utilities 

installation menu 

nstall (M) install commands _ 
nteger absolute value 



integer and ba8e-64 ASCII string 
nteger data 



integer strtol(S) 

ntegers and long integers 
integers 13tol(S) ltol3(S) 

terface subroutines 

interface 



interface to STREAMS error logging 

interpolate smooth curves 

interpret asa carriage control 

interpreter 



interpreter with C-like syntax 

interprocess channel 

inter-process 



cation facilities 

interprocess communication package 

interval 

interval 

interval 

intro(C) introduce comnanda 



intro(CP) introduce software development 
introduce connands 



introduce miscellaneous features and 

introduce software development coimnands 
introduce system calls, functions, and _ 

introduction to file formats 

intro(F) introduction to file formats 

Intro(M) introduce miscellaneous 

intro(S) introduce system calls. 

invoke a compiler-compiler 

invoke a macro processor 

invoke a reminder service 

invoke a screen-oriented display editor 

invoke a text editor 

invoke the Business shell 

invoke the C compiler 

invoke the ed text editor 

invoke the edit text editor 

invoke the link editor 



clrl(M) 

inode(M) 

ncheck(M) 

inode(M) 

dt(M) 

gets(C) 

line(C) 

acanf (S) 

ungetc(S) 

fwrite(S) 

poll(S) 

stdio(S) 

ferror(S) 

uustat (C) 

instalKM) 

cpset (C) 

options (M) 

instalKM) 

abs(S) 

a641(S) 

sputl(S) 

strtoKS) 

13tol(S) 

13tol(S) 

plot(S) 

termio(M) 

log(M) 

spline(C) 

asa(C) 

sh(C) 

csh(C) 

pipe(S) 

ipcs(C) 

stdipc(S) 
. nap(S) 

sleep(C) 

sleep(S) 

intro(C: 

intro(CP : 

intro(C) 

intro(M) 

intro(CP) 

intro(S) 

intro(F) 

intro(F) 

intro(M) 

intro(S) 

yacc(CP) 

m4(CP) 
calendar (C) 
_ vi(C) 
_ ex(C) 
_ bsh(C) 
cc(CP) 
_ ed(C) 
edit(C) 
Id(CP) 
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xld(CP) 
masm(CF) 
sh(C) rsh(C) 
sed(C) 
adb(C) 

sulogln(M) special login program 

abort (S) generate an 
set, shared memory id 
communication facilities status 
classify characters ctype(S) 
ctype(S) isdigit(S) ispunct(S) 
ttyname(S) 

ctype(S) iBalpha(S) islower(S) 
classify characters ctype(S) 
characters ctype(S) isalpha(S) 
isnan(S) isnanf(S) 
point NaN isnan(S) 
floating point NaN 
characters ctype(S) isdigit(S) 
system(S) 
bessel(5) 

uustat(C) UUCP status inquiry and 
join(C) 

numbers drand48(S) seed48(S) srand48(S) 
Idunix(M) configurable 
mkunix(M) make bootable system file with 
makekey(M) generate an encryption 
klllall(C) 



group of processes 
mem(H) 

integers and long integers 
base-64 ASCII string a641(S) 
labelit(M) copy file system with 
systems 
checking volcopy(M) 
labelit(C) provide 
awk(C) pattern scanning and processing 
bc(C) arbitrary-precision arithmetic 
nawk(C) pattern scanning and processing 
cpp(CP) the C 
lint (CP) check C 
bdiff(C) compare files too 
banner (C) print 
hplpR(C) filter files for printing on 

at(C) batch(C) execute commands at a 

IdcloBe(S) 
member of an archive file 
reading Idopen(S) 



floating-point numbers frexp(S) modf(S) 



invoke the link editor 

invoke the macro assembler 

invoke the shell command interpreter _ 

invoke the stream editor 

invoke x . out general purpose debugger 
invoked by init 



ioctl(S) control device 
lOT fault 



ipcrm(C) remove message queue, semphore 
ipcs(C) report inter-process 



salpha(S) islower(S) iscntrl(S) 

sascii(S) classify characters 

isatty(S) find name of a terminal 

iscntrl(S) classify characters 

digit (S) ispunct(S) isascii(S) 
Islower(S) iscntrl(S) classify 



isnand(S) test for floating point NaN 
isnanf(S) isnand(S) test for floating 
isnan(S) isnanf(S) isnand(S) test for 

ispunct(S) isascil(S) classify 

issue a shell command 



jO(S) yO(S) Bessel functions 

job control 

join two relations 



xld(CP) 
masm ( CP ) 
sh(C) 
sed(C) 
adb(C) 
sulogin(M) 
ioctl(S) 
abort ( S ) 
ipcrm(C) 
ipcs(C) 
ctype(S) 
ctype(S) 
ttyname (S) 
ctype(S) 
ctype(S) 
ctype(S) 
isnan(S) 
isnan(S) 
isnan(S) 
ctype(S) 
system(S) 
besseKS) 
uustat(C) 
join(C) 
join(C) 
drand48(S) 
Idunix(M) 
mkunix(M) 
makekey(M) 
killall(C) 
killall(C) 
. kill(C) 
. kill(S) 
mem(M) 
13tol(S) 
a641(S) 
volcopy (H) 
labelit(C) 
volcopy(M) 
labelit(C) 
awk(C) 
. bc(C) 
nawk(C) 
cpp(CP) 
lint (CP) 
bdiff(C) 
banner (C) 
. hplp(C) 
last(C) 
. at(C) 

layout (M) manage hard disk partitions layout (M) 

Idaclose(S) close a COFF file ldclose{S) 

Idahread(S) read the archive header of a Idahread(S) 
Idaopen(S) open a common object file for Idopen(S) 
Idclose(S) Idaclose(S) close a COFF file idcloae(S) 

Id(CP) invoke the link editor Id(CP) 

Idexp(S) manipulate parts of frexp(S) 



join(C) join two relations 

Jrand48(S) generate pseudo-random 

kernel linker 

kernel symbol table 

key 

kill all active processes 

killall(C) kill all active processes 
kill(C) terminate a process 



klll(S) send a signal to a process or a 
kraem(M) memory image file 



13tol(S) ltol3(S) convert between 3-byte 
164a (S) convert between long integer and 
label checking volcopy(M) 



labelit(C) provide labels for file 

labellt(M) copy tile system with label 

labels for file systems 

language 

language 

language 

Language Preprocessor 

language usage and syntax 

large for diff . 

large letters 



LaserJet printer hplp(C) 

last(C) print last record of user logins 
later time 
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routines 

COFF file 
COFF ayinbol table entry 
entries of a COFF function Idlread(S) 
number entries of a COFF function 
of a section of a COFF file 
header of a coiimon object 
object file for reading 
a section of a COFF file 
section header of a COFF file 
symbol table entry of a COFF file 
entry of a COFF file 
a COFF file 

leave (C) remind you when you have to 
leave 

getopt(S) get option 
banner (C) print large 
analysis 

lex(CP) generate programs for 
Isearch(S) 
ar(CP) maintain archives and 
chkshllbCCP) tool for comparing shared 
introduce system calls, functions, and 
ranllb(CP) convert archives to random 
xar(CP) maintain archives and 
find ordering relation for object 
mkshlib(CP) create a shared 
shuttype(S) get and set UPS shutdown 
ullmit(S) get and set user 
implement atlon-apecific constants 
dlal(S) establish an out-going terminal 
set terminal type, modes, speed. 

file llnenum(F) 
Idlread(S) Idlltem(S) manipulate 
COFF file Idlseek(S) seek to 
strip (CP) remove symbols and 
nl(C) add 
llne(C) read one 
Ipd(M) 

cancel(C) send/cancel requests to LP 
turn on/off 
Ipdisable(C) enable/dlaable LP 
Iplnit(H) add new 
laearch(S) Ifind(S) 

coaaion object tile 
coaai(C) aelect/reject 
fold(C) fold long 
unlq(C) report repeated 
look(C) find 
num(C) number 
rev(C) reverse 
head(C) print the firat few 
ssp(C) remove conaecutive blank 
wc(C) count 
link(H) unllnk(H) 



Idfcn(F) coamon object file access 
Idfhread(S) read the file header of 
Idgetnaffle(S) retrieve symbol name fo 
ldliten(S} manipulate line number 



Idfcn(F) 
Idfhread(S) 
Idgetname(S) 
Idlread(S) 



Idlread(S) Idlitem(S) manipulate line Idlread(S) 



Idlseek(S) seek to line number entries 
IdohseekCS) seek to the optional file 
Idopen(S) Idaopen(S) open a comnon 



Idrseek(S) seek to relocation entries of 
Idshread(S) read an indexed/named 



Idtblndex(S) compute the Index of a 

Idtbread(S) read an indexed symbol table 
Idtbseek(S) seek to the symbol table of 

Idunlx(M) configurable kernel linker 

leave 

leave(C) remind you when you have to 

letter from argument vector 

letters 

lex(CP) generate programs for lexical 

lexical analysis 



Ifind(S) linear search and update 

libraries 

libraries 



libraries intro(S) 

libraries 

libraries 



library lorder(CP) 

library 

limits 

limits 



limlts(F) file header for 
line connection 



Idlseek(S) 

IdohseekCS) 

Idopen(S) 

Idrseek(S) 

Idahread(S) 

Idtbindex(S) 

Idtbread(S) 

Idtbseek(S) 

Idunlx(M) 

leave(C) 

leave (C) 

getopt(S) 

banner (C) 

lex(CP) 

lex (CP) 

Isearch(S) 

ar(CP) 

chkshlib(CP) 
Intro(S) 
ranllb(CP) 
xar(CP) 
lorder(CP) 
mkshllb(CP) 
shut type (S) 
ulimit(S) 
limits (F) 
dlal(S) 
uugetty(M) 



line number entries of a COFF function 
line number entrlea of a section of a _ 

line numbera from COFF file 

line numbers to a file 

line of Input 

line printer daemon 

line printer lp{C) 



line printer scheduler 

line printers Ipenable(C) 
line printers 



line discipline uugetty(M) 

line number entries in a common object linenum(F) 

Idlread(S) 
Idlseek(S) 
St rip (CP) 
nl(C) 
line(C) 
Ipd(H) 
lp(C) 
Ipon(M) 
Ipenable(C) 
Ipinlt(M) 
Isearch(S) 
line(C) 
llnenum(F) 
comm(C) 
fold(C) 
unlq(C) 
. look(C) 

num(C) 
. rev(C) 
head(C) 
ssp(C) 
. wc(C) 
link(M) 



linear search and update 

llne(C) read one line of input 

llnenum(F) line number entries in a _ 

lines common to two aorted fllea 

llnea for finite width output device 
lines In a file 



llnea in a aorted liat 
llnea 



linea of a file 

llnea of a atream 
llnea 



llnea , words , and characters 

link and unlink fllea and directories 
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Id(CP) invoke the 
a.out(F) format of assembler and 
xld(CP) invoke the 
link(S) 
ln(C) make a 
Idunix(H) configurable kernel 
and directories 

syntax 
ls(C) 

xlist(S) fxlist(S) get name 
checklist (M) 
look(C) find lines in a sorted 
nlist(S) get entries from name 
nm(CP) print name 
terminals (M) 

varargs(F) handles variable argument 
print formatted output of varargs 
f rom(C) 
xnm(CP) print name 
COFF file 

cref(CP) make a cross-reference 
list (CP) produce C source 

string ctime(S) gmtime(S) 
program whereis(C) 
end(S) edata(S) etext(S) last 
lock(S) 
plock(S) 

lockf(S) record 
read/write 

locking(S) 
errprint(M) display error 
gamma ( S ) 

set maximum number of users allowed to 
newgrp(C) 

exp(S) pow(S) log(S) exponential, 
exp(S) sqrt(S) exponential. 
Btrclean(M) STREAMS error 
strerr(M) STREAMS error 
log(M) interface to STREAMS error 
sizefs(C) determine the size of a 
aetlogin(S) get 
logname(C) get 
cuserid(S) get character 
logname(S) return 
passHd(C) change 
8ulogin(H) special 
ttys(«) 

profile(M) set up environment at 

la3t(C) print last record of user 
disable (C) disable 
enable (C) enable 
logging 



link editor 

link editor output 

link editor 

link to a file 

link to a file 

linker 

link(M) unllnk(M) link and unlink files 

link(S) link to a file 

lint (CP) check C language usage and 

list contents of directories 

list entries from files 

list file systems processed by fsck 

list 

list 

list of common object file 

list of supported terminals 



list 

list vprintf(S) vfprintf(S) vsprintf(S) 

list who my mail is from 

list 

list (CP) produce C source listing from 

listing 

listing from COFF file 



ln(C) make a link to a file 

localtime(S) convert date and time to 
locate source, binary, or manual for _ 
locations in program 



lock a process in primary memory 

lock process, text, or data in memory 

lockf(S) record locking on files 

locking on files 



locking(S) lock/unlock a file region for 
lock(S) lock a process in primary memory 
lock/unlock a file region for read/write 

log contents 

log gamma function 



log in numu8ers(S) get and 

log user into a new group 

logarithm, and power functions 

logarithm, and square root functi 

logger cleanup program 

logger daemon 

logging 



logical disk drive 

login name 

login name 



login name of the user 

login name of user 

login password 



login program invoked by init 

login terminals file 

login time 



login (C) give you syste 
logins 



logins on a port 

logins on a port 

log(H) interface to STREAMS error 



Id(CP) 

a. out(F) 

xld(CP) 

link(S) 

ln(C) 

Idunix(M) 

link(M) 

link(S) 

lint (CP) 

13(C) 

xlist(S) 
checklist (M) 
look(C) 
nlist(S) 
nm(CP) 

terminals (M) 
varargs (F) 
vprintf(S) 
from(C) 
xnm(CP) 
list (CP) 
cref(CP) 
list (CP) 

. ln{C) 
ctime(S) 
whereis(C) 
end(S) 
lock(S) 
plock(S) 
lockf(S) 
lockf(S) 
locking(S) 
lock(S) 
locking(S) 
errprint(M) 
gamma(S) 
numu8ers(S) 
newgrp(C) 

, exp(S) 
exp(S) 
strclean(M) 
atrerr(M) 

. log(M) 
sizefs(C) 
get login (S) 
logname(C) 
cuserid(S) 
logname(S) 
passwd(C) 
sulogin(M) 
tty8(M) 
profile(M) 
login (C) 
last(C) 
disable(C) 
enable (C) 

. log(M) 
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functions exp(S) pow(S) 
setimp(S) 
fleece(C) 

object library 
lp(C) cancel(C) send/cancel requests to 
Ipenable(C) Ipdisable(C) enable/disable 
Ipsched(M) Ipshut(H) start/stop the 
Ipsched(M) Ipmove(M) move 
Ipadmin(M) configure the 
Ipstat(C) print 
system 
LP line printer 
printers Ipenable(C) 

LP line printers 

Ipsched(M) 
turn on/off 
spooler 

request scheduler 
scheduler Ipsched(n) 

drand48(S) mrand48(S) nrand48(S) 

update 

and long integers 13tol(S) 
values (F) 

aftp(C) transfer files between Altos 
masm(CP) invoke the 
m4(CP) invoke a 
enrolKC) xsend(C) xget(C) secret 
mail(C) system 
aliases (H) 

aliashash(M) rebuild data base for 

troin(C) list who my 
malloc(S) 

malloc(S) free(S) realloc(S) fast 
mallinfo(S) mallopt(S) calloc(S) fast 
ar(CP) 
3car(CP) 
of programs make(C) 
groups of programs 



main memory allocator malloc(S) 
memory allocator 



calloc(S) fast main memory allocator 
allocator malloc(S) mallinfo(S) 



logname(C) get login name 

logname(S) return login name of user 

log(S) exponential, logarithm, and power 
longjmp(S) non-local goto 



look for files in home directories 

look(C) find lines in a sorted list 

lorder(CP) find ordering relation for 

LP line printer 

LP line printers 

LP request scheduler 

LP requests 

LP spooling system 



LP status information 

Ipadmin(M) configure the LP spooling 

lp(C) cancel (C) send/cancel requests to _ 

Ipdisable(C) enable/disable LP line 

Ipd(M) line printer daemon 

Ipenable(C) Ipdisable(C) enable/disable _ 

Ipinit(M) add new line printers 

Ipmove(M) move LP requests 

Ipon(M) line printer scheduler 



Ipr(C) route named files to printer 

Ipsched(H) Ipmove(N) move LP requests 
Ipsched(H) Ipshut(M) start/stop the LP 

Ipshut(M) start/stop the LP request 

Ipstat(C) print LP status information 

lrand48(S) generate pseudo-random/ 

l8(C) list contents of directories 



Isearch(S) Ifind(S) linear search and 

Iseek(S) move read/write file pointer 

ltol3(S) convert between 3-byte integers 

m4(CP) invoke a macro processor 

machine-dependent values 

machines 

macro assembler 

macro processor 

mail 

mail 

mail alias file 

mail alias file 

mail(C) system mail 

mail ia from 



main memory allocator 

main memory allocator 

main memory allocator malloc(S) 

maintain archives and libraries 

maintain archives and libraries 

maintain, update, and regenerate groups 
make(C) maintain, update, and regenerate 
makedevs(M) create special device files 

makekey(M) generate an encryption key 

makettys(H) create tty special files 

mallinfo(S) mallopt(S) calloc(S) fast 

malloc(S) free(S) realloc(S) fast main _ 

malloc(S) main memory allocator 

malloc(S) mallinfo(S) mallopt(S) 



mallopt(S) calloc(S) fast main memory 



logname(C) 
iogname(S} 
exp ( S ) 
set jmp(S) 
tleece(C) 
look(C) 
lorder(CP) 
lp(C) 

Ipenable(C) 

Ipsched(M) 

Ipsched(M) 

Ipadmin (M) 

Ipatat(C) 

Ipadmin (M) 

lp(C) 

Ipenable(C) 

Ipd(M) 

Ipenable(C) 

Ipinit(M) 

Ipsched(M) 

Ipon(M) 

Ipr(C) 

Ipsched(M) 

Ipsched(M) 

Ipsched(M) 

Ipstat(C) 

drand48(S) 

ls(C) 

Isearch(S) 

Iseek(S) 

IStoKS) 

m4(CP) 

values (F) 

aftp(C) 

masm(CP) 

m4(CP) 

enroll (C) 

mail(C) 

aliases (M) 

aliashash(M) 

mail(C) 

from(C) 

malloc ( S ) 

malloc(S) 

malloc (S) 

ar(CP) 

xar(CP) 

make(C) 

make(C) 

makedevs(M) 

makekey(H) 

makettys(M) 

malloc (S) 

malloc (S) 

malloc (S) 

malloc (S) 

malloc ( S ) 
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tsearch(S) tfind(S) tdelete(S) twalk(S) 
layout (M) 

hsearch(S) hdeBtroy(S) hcreate(S) 
crontab(C) 

sigrelse(S) *lglgnore(S) signal 
sigaet(S) slgpause(S) signal 
function Idlread(S) Idlitem(S) 
numbers frexp(S) modf(S) Idexp(S) 
section mcs(CP) 
whereis(C) locate source, binary, or 
sysalto3(S) 

drive information written during 
add new bad sectors to the bad sector 
ascil(N) 

umask(C) set file-creation mode 
umask(S) set and get file creation 

master (M) 

regexp(F) regular expression compile and 
regexp(S) compile regular expression and 
math(F) 



in numuserB(S) get and set 
comment section 
Idahread(S) read the archive header of a 
memory ( S ) 

memory (S) memset(S) memcpy(S) memcmp(S) 
memory (S) memset(S) memcpy(S) 
operations memory (S) memset(S) 

malloc(S) free(S) realloc(S) fast main 
malloc(S) main 
mallopt(S) calloc(S) fast main 
shmctKS) shared 
message queue, semphore set, shared 
mem(N) kmem(M) 
lock(S) lock a process in primary 
memory (S) memccpy(S) 
memset(S) memcpy(S) memcmp(S) memchr(S) 
shmop(S) shared 
plock(S) lock process, text, or data in 
shaget(S) get shared 

menchr(S) ■enory operations 
memory operations memory(S) 
options (M) floppy disk installation 
menus (M) format of Business Shell 
digest ( C) create 
system 
aort(C) sort and 
to a terminal 
msgctl(S) 
mkstr(C) create an error 
mkstr(CP) create an error 
getmsg(S) get next 



manage binary search trees 

manage hard disk partitions 

manage hash search tables 

manage user crontab files 

management aigset(S) 8ighold(S) 
management 



manipulate line number entries of a COFF 

manipulate parts of floating-point 

manipulate the object file comment 

manual for program 



manufacturer specific system requests 

manufacturing drive(C) 

map badblock(C) 



map of the ASCII character set 

mask 

mask 



masm(CP) invoke the macro assembler 
master configuration database 



master(M) master configuration database 

match routines 

match routines 



math functions and constants 

matherr(S) error-handling function 

math(F) math functions and constants 

maximum number of users allowed to log 

mcs(CP) manipulate the object file 

member of an archive file 



memccpy(S) memory operations 

memchr(S) memory operations 

memcmp(S) memchr(S) memory operations 
memcpy(S) memcmp(S) memchr(S) memory _ 

mem(M) kmem(M) memory image file 

memory allocator 

memory allocator 



memory allocator roalloc(S) mallinfo(S) 

memory control operations 

memory id Ipcnn(C) remove 

memory image file 

memory 

memory operations 

memory operations memory (S) 

memory operations 

memory 



memory segment Identifier 



taearchlS) 
layout (M) 
hsearch(5) 
crontab(C) 
sigset(S) 
sigset (S ) 
Idlread(S) 
frexp(S) 
mcsCCP) 
whereis(C) 
syaaltos(S) 
drive (C) 
badblock(C) 
aacii(M) 
umask (C) 
umaak(S) 
masm(CP) 
master(M) 
master(M) 
regexp(F) 
regexp ( S ) 
math(F) 
matherrCS) 
math(F) 
numusers (S) 
mcs(CP) 
Idahread(S) 
memory ( S ) 
memory ( S ) 
memory(S) 
memory ( S ) 
mem(M) 
malloc(S) 
malloc(S) 
malloc(S) 
ShmctKS) 
ipcrm(C) 
mem(M) 
lock(S) 
memory ( S ) 
memory ( S ) 
shmop ( S ) 
plock(S) 
shmget ( S ) 
memory ( S ) 
memory ( S ) 



memory (S) memccpy(S) memory operations 
memory (S) memset(S) mefflcpy(S) memcmp(S) 
memset(S) memcpy(S) memcmp(S) memchr(S) _ memory (S) 

menu options (M) 

menu system menus (M) 

digest (C) 



menu systemCs) for the Business Shell 
menus (H) format of Business Shell menu 
merge files 



mesg(C) allow or disallow messages sent 

message control operations 

message file from C source 

message file from C source 

message off a stream 



menus (M) 

sort(C) 

mesg(C) 

msgctl(S) 

rakstr(C) 

mkstr(CP) 

getmsg(S) 
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putinsg(S) send a 
m>gop(S) 
nisgget(S) get 
memory id ipcnn<C) remove 
perror(S) system error 
mesg(C) allow or disallow 
strace(M) print STREAHS trace 
3y3_errli3t (S) errno(S) system error 
clone (M) open any 
intro(M) introduce 
bootable object file 



or ordinary file 



from C source 
from C source 



driver symbol table 
kernel symbol table 



getty(M) set terminal 
uinask(C) set file-creation 
bring system up multl/single-user 
chfflod(S) change 
setmodem(C) set up tty port for a 
uugetty(M) set terminal type, 
taet(C) set terminal 
setmode(C) printer 
floating-point numbers frexp(S) 
settime(C) change the access and 
touch(C) update access and 
utime(S) set file access and 

time 
mount (S) 
multiple file systems 
structure 
mnttab(M) 

mount (C) uiiiount(C) 
mountall(C) uiaountall (C) 
lp«ched(H) Ipmove(M) 
Iseek(S) 
mv(C) 

generate pseudo- random/ drand48(S) 
dos(C) access 



mountall(C) umountall(C) mount/unmount 
poll(S) STREAMS input/output 
singleuser(C) bring system up 
rc2(M) commands for 



message on a stream 

message operations 

message queue 

message queue, semphore set, shared 
messages 

messages sent to a terminal 

messages 



putmsg( S I 

msgop<S) 

msgget (S) 

ipcrm(C) 

perror(S) 

mesg(C) 



3tra 



S(M) 



messages sys_nerr(S) 

minor device on STREAMS driver 

miscellaneous features and files 

mkboot(H) convert object file to 

mkdir(C) make a directory 

mkdir(S) make a directory 

mkfs(M) construct a file system 

mknod(C) build special files 

mknod(S} make a directory, or a special 

mkshlib(CP> create a shared library 

mkatr(C) create an error message file 

mkstr(CP) create an error message file 

mktemp(S) make a unique file name 

mkunix(M) make bootable system file witt 
mkunlx(M) make bootable system file with 

mkvers(CP) generate a what string 

mnttab(N) mounted file system table 

mode 

mode mask 

mode multluser(C) 8ingleuser(C) 

mode of file 

modem 

modes, speed, line discipline 

modes 

modes utility 

modf(S) Idexp(S) manipulate parts of 

modification dates of files 

modification times 
modification times 



8ys_nerr(S) 
clone(M) 
intro(M) 
mkboot (M) 
mkdir(C) 
mkdir(S) 
mkfB(M) 
mknod(C) 
mknod(S) 
mkshlib(CP) 
mkstr(C) 
mkstr(CP) 
mktemp ( S } 
mkunix (M) 
mkunix(M) 
mkvers(CP) 
mnttab(M) 
getty(M) 
umask(C) 
multiuser(C) 
chmod(S) 
setmodem(C} 
uugetty(M) 
tset(C) 
setmode(C) 
frexp(S) 
settimefO 
touch(C) 
utime(S) 

monitor(S) prepare execution profile monitor(S) 

more(C) view a file one full screen at a more(C) 

mount a file system mount (S) 

mountall (C) 
mount (C) 
mnttab(M) 



file 



mountall(C) umountall(C) mount/unmount _ 
mount(C) umount(C) mount/unmount a file 

mounted file system table 

mount (S) mount a file system 

mount /unmount a file structure 

mount/unmount multiple file systems 

move LP requests 



move read/write file pointer 

move (rename) files and directories 

mrand48(S) nrand48(S) lrand48(S) 

MS-DOS files 



msgctKS) message control operations 

msgget (S) get message queue 

msgop(S) message operations 

multiple file systems 

multiplexing 



multl/single-user mode multiuser(C) 
multi-user environment 



mount (S) 
mount (C) 
mountall (C) 
Ipsched(M) 
Iseek(S) 
mv(C) 

drand48(S) 
dos(C) 
magctl (S) 
msgget (S) 
msgop(S) 
mountall (C) 
polKS) 
multiuser(C) 
rc2(M) 
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up nultl/slngle-us*r mode 
directories 
tinpnaiii(S) teiipnaiii(S) create a 
Idgetnaaie(S) retrieve symbol 
ctemid(S) generate file 
getpw(S) get 

getenv(S) return value for environment 
getlogin(S) get login 
xllst(S) fxllst(S) get 
nlist(S) get entries from 
nm(CP) print 
xnm(CP) print 
logname(C) get login 
mktemp(S) make a unique file 
ttynane(S) Isatty(S) find 
uname(S) get 
getcwd(S) get path 
cuserid(S) get character login 
logname(S) return login 
devnm(C) Identify device 
pwd(C) print working directory 
tty(C) get the current port 
Ipr(C) route 
term(M) conventional 
ncheck(H) generate path 
ld(C) print user and group ID and 
Isnand(S) test for floating point 
Interval 
language 

semaphore resource Haltsen(S) 
numbers 

getmsg(S) get 

dbm(S) dbmlnlt(S) fetch(S) 
priority 



file 
and quits 
setjmp(S) longjmp(S) 
fBlse(C) return with a 
pseudo-random/ drand48(S) mrand48(S) 
null(N) 

llnenun(F) line 
Idlread(S) Idlltaii(S) manipulate line 
file Idlseek(S) seek to line 
factor(C) factor a 
ni»(C) 
df(H) report 
numusers(S) get and set maximum 
randoa(C) generate a random 
convert string to double-precision 
ecvt(S) convert floating-point 
erand48(S) generate pseudo-random 
lrand48(S) generate pseudo-random 



multiuser (C) slngleuser(C) bring syst 

nv(C) move (rename) files and 

name for a temporary file 



multiuser(C) 
mv(C) 
tmpnam(S) 
Idgetname(S) 
ctermid(S) 
getpw(S) 
getenv(S) 
getlogin(S) 
xli8t(S) 
nlist(S) 
nm(CP) 
xnm(CP) 
logname(C) 
mktemp(S) 
ttyname(S) 
uname(S) 
getcwd(S) 
cuserid(S) 
logname ( S ) 
devnm(C) 
pwd(C) 
tty(C) 
Ipr(C) 
term(H) 
ncheck(M) 
id(C) 

isnan(S) 

nap(S) suspend execution for a short nap(S) 

naHk(C) pattern scanning and processing _ nawk(C) 

nb«faltsem(S) wait and check access to waltsem(S) 

ncheck(N) generate path names from Inode ncheck(M) 



name for COFF symbol table entry 

name for terminal 

name from UID 

name 

name 

name list entries from files 

name list 

name list of common object file _ 

name list 

name 

name 

name of a terminal 

name of current UNIX system 

name of current working directory 

name of the user 

name of user 

name on which files reside 

name 

name 

named files to printer spooler 

names for terminals 

names from inode numbers 

names 

NaN i8nan(S) isnanfCS) 



neHgrp(C) log user into a new group 
next message off a stream 



nextkey(S) perform database functions 
nlce(C) run a coomand at a different 
nlce(S) change priority of a process 
nl(C) add line numbers to a file 



nlist(S) get entries from name list 

nm(CP) print name list of comnon object 
nohup(C) run a command immune to hangups 

non-local goto 

nonzero exit value 



nrand48(S) lrand48(S) generate 
null file 



nulKN) null file 

number entries in a common object file 
number entries of a COFF function 



number entries of a section of a COFF 

number 

number lines 



number of free disk blocks and Inodea 

number of users allowed to log in 

number 

number Btrtod(S) atof(S) 

number to string 



numbers drand48(S) 

numbers /mrand48(S) nrand48(S) 



newgrp(C) 

getmBg(S) 

dbm(S) 

nlce(C) 

nlce(S) 

nl(C) 

nllst(S) 

nm(CP) 

nohup(C) 

set jmp(S) 

false (C) 

drand48(S) 

null(M) 

null(M) 

llnenum(F) 

Idlread(S) 

Idlseek(S) 

factor (C) 

num(C) 

df (M) 

numusers ( S ) 

random(C) 

strtod(S) 

ecvt(S) 

drand48(S) 

drand48(S) 
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jrand48(S) generate pseudo-random 
manipulate parts of floating-point 
strip(CP) remove symbols and line 
ncheck(M) generate path names from inode 
nl(C) add line 

of users allowed to log in 
dis(CP) 
Idfcn(F) common 
mcs(CP) manipulate the 
cprs(CP) compresse a common 
dump(CP) dump selected parts of an 
Idopen(S) Idaopen(S) open a common 
f ixobj (CP) convert an 
hdr(C) display selected parts of an 
line number entries in a common 
convert object file to bootable 
nm(CP) print name list of common 
relocation of information for a common 
scnhdr(F) section header for a common 
find the printable strings in an 
syms ( F ) common 
mkboot ( M ) convert 
oonv(CP) convert common 
filehdr(F) file header for common 
size(C) print section sizes of common 
to the optional file header of a common 
lorder(CP) find ordering relation for 
od(C) display files in 

f ixobj (CP) convert an object file from 
Idopen(S) Idaopen(S) 
opensem(S) 
fopen(S) fdopen(S) freopen(S) 
clone (H) 

dup(S) dup2(S) duplicate an 
open ( S ) 

directory(S) telldir(S) readdir(S) 



rcO(M) commands to stop the 
rewlnddir(S) seekdir(S) directory 
readdir(S) opendir(S) directory 
meiiiory(S) meaccpy(S) memory 
memcpy(S) memcnp(S) iiieinchr(S) memory 
nagctl(S) message control 
■agop(S) message 
senctKS) senaphore control 
semop ( S ) semaphore 
shmctl(S) shared memory control 
ahmop(S) shared memory 
strdup(S) strpbrk(S) strcmp(S) string 
strcpy(S) strlen(S) «trchr(S) string 
strlng(S) strspn(S) strtok(S) string 
curses (S) terminal screen handling and 
getopt(S) get 
Idohaeek(S) seek to the 



numbers drand48(S) seed48(S) srand48(S) 

numbers frexp(S) modf(S) Idexp(S) 

numbers from COFF file 

numbers 

numbers to a file 

num(C) number lines 



numusers(S) get and set maximum number 

object code disassembler 

object file access routines 

object file comment section 

object file 

object file 



object file for reading 

object file from OMF to COFF 
object file 



object file linenum(F) 
object file mkboot (M) 
object file 



object file reloc(F) 
object file 



object file strings (C) 

object file symbol table format 

object file to bootable object file 

object files 

object files 

object files 



object Idohseek(S) seek 

object library 

octal format 



od(C) display files in octal format 
OMF to COFF 



open a common object file for reading 

open a semaphore 

open a stream 



drand48(S> 

frexp(S) 

strip(CP) 

ncheck(M) 

nl(C) 

num(C) 

numusers ( S ) 

dls(CP) 

Idfcn(F) 

mcs ( CP ) 

cprs(CP) 

dump ( CP ) 

Idopen(S) 

f ixobj (CP) 

hdr(C) 

linen um(F) 

mkboot (M) 

nm(CP) 

reloc(F) 

scnhdr(F) 

strings (C) 

syms(F) 

mkboot (M) 

conv(CP) 

fllehdr(F) 

size(C) 

Idohseek(S) 

lorder(CP) 

. od(C) 

. od(C) 
f ixobj (CP) 
Idopen(S) 
opensem(S) 
fopen(S) 



open any minor device on STREAMS driver _ clone (M) 



open file descriptor 

open for reading or writing 

opendlr(S) directory operations 

open(S) open for reading or writing 

openseffl(S) open a semaphore 

operating system 



operations directory(S) closedlr(S) 
operations dlrectory(S) telldlr(S) 
operations 



operations memory (S) memset(S) 

operations 

operations 

operations 

operations 

operations 

operations 



operations strlng(S) strcat(S) 
operations strlng(S) 8trncmp(S) 
operations 



optimization package 

option letter from argument vector 

optional file header of a connon object 



dup(S) 
open ( S ) 
directory (S) 
open ( S ) 
opensem(S) 
rcO(M) 

directory (S) 

directory (S) 

memory(S) 

memory(S) 

msgctl(S) 

msgop ( S ) 

semctl(S) 

semop(S) 

shmctl(S) 

shmop ( S ) 

string(S) 

strlng(S) 

string(S) 

curses ( S ) 

getopt(S) 

Idohseek(S) 
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tcntl(F) file control 
atty(C) sat tha 
xttY(C) aet the 
getopt(C) parse comnand 
Oetopts(C) parse coiranand 

lorder(CP) find 
make a directory, or a special or 
dlal(S) establish an 
format of assembler and link editor 
fold(C) fold long lines for finite width 
vtprintf(S) vsprlntKS) print formatted 
pr(C) print fllea on the standard 
sprlntf(S) fprintf(S) print formatted 
sysdef (M) 
chown ( S ) change 
chown(C) chgrp(C) change 
quot(C) aunmarlze file system 
screen handling and optimization 
sar(M) system activity report 
stdio(S) standard buffered input/output 
standard interprocess communication 
expand files 
tk(C) 

get process, process group, and 
getopt(C) 
getopts(C) 
tail(C) deliver the last 
layout (H) manage hard disk 
dump (CP) dump selected 
hdr(C) display selected 
frexp(S) modf(S) Idexp(S) manipulate 



crypt (S) 

fgetpwent(S) endpwent(S) aetpwentCS) get 
getpwent(S) getpwnain(S) getpwuld(S) get 
putpHent(S) write 
passwd(M) 
getpas(S) read a 
passwd(C) change login 
pwck(M) grpck(H) check 
getcwd(S) get 
ncheck(H) generate 
dlrnane(C> deliver portions of 
grep(C) search a file tor a 
awk(C) 
nawk(C) 

egrep(C) search file tor 

files pack(C) 
process popen(S) 

dbm(S) dbminit(S) fetch(S) nextkeyCS) 
dbm(S) firstkey(S) store(S) fetch(S) 
check the uucp directories and 
chmod(C) change 



options 

options for a port 
optiona for a port 

optlona 

options 



options (H) floppy disk installation menu 

ordering relation for object library 

ordinary file mknod(S) 



out-going terminal line connection 

output a.out(F) 

output device 



output of varargs list vprlntf(S) 
output 



output print f(S) 

output system definition _ 
owner and group of a file 

owner or group ID 

ownership 



package curses (S) terminal 

package 

package 



package stdlpc(S) ftok(S) 

pack(C) pcat(C) unpack (C) compress and 

paginator for Tektronix 4014 

parent process IDs getpld(S) 

parse command options 

parse command options 

part of a file 

partitions 



parts of an object file 

parts of an object file 

parts of floating-point numbers 
passwd(C> change login password 
passwd(M) password file 



password and tile encryption functions 

password file entry getpwent(S) 

password file entry 

password file entry 

password file 

password 

password 

password/ group file 

path name of current working directory 

path names from inode numbers 

pathnames basenane(C) 

pattern ■ 



pattern scanning and processing language 
pattern scanning and processing language 

pattern using full regular expression 

pause(S) suspend process until signal pauae(S) 



fcntl(F) 
stty(C) 
xtty(C) 
getopt(C) 
getopts(C) 
options (M) 
lorder(CP) 
mknod(S) 
dlal(S) 
a.out(F) 
fold(C) 
vprintr(S) 
pr(C) 
prlntf (S) 
sysdef (M) 
chown ( S ) 
chown <C) 
quot (C) 
curses ( S ) 
aar(M) 
stdlo(S) 
stdlpc(S) 
pack(C) 
tk(C) 
getpid(S) 
getopt (C) 
getopts(C) 
tail(C) 
layout (M) 
dump (CP) 
hdr(C) 
frexp(S) 
passwd(C) 
passwd(M) 
crypt(S) 
getpwent (S) 
getpwent(S) 
putpwent (S) 
passwd(M) 
getpas(S) 
passwd(C) 
pwck(M) 
getcwd(S) 
ncheck(M) 
basename(C) 
grep(C) 
awk(C) 
nawk(C) 
egrep(C) 



pcat(C) unpack (C) compress and expand 

pclose(S) initiate pipe to/from a 

pcontlg(C) set port configuration 

perform database functions 

perform database functions 

permissions file uucheck(M) 



permissions of a tile or directory 



pack(C) 

popen ( S ) 

pconf ig(C) 

dbffl(S) 

dbffl(S) 

uucheck(M) 

chmod(C) 
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split(C) aplit a file into 
tee(C) create a tee in a 
popen(S) pciose(S) initiate 

memory 

f pgetround(S) fpgetmaak(S) IEEE floating 
tpgetsticky(S) IEEE floating 
fpgetround(S) fpsetmask(S) IEEE floating 
fpsetround(S) IEEE floating 
fpsetaticky(S) IEEE floating 
isnanf(S) isnand(S) test for floating 
ftell(S) rewind(S) repoaition a file 
Iseek(S) move read/write file 
multiplexing 
a process 
pconfig(C) set 
disable (C) disable logins on a 
enable (C) enable logins on a 
setmodem(C) set up tty 
tty(C) get the current 
stty(C) set the options for a 
xtty(C) set the options for a 
basename(C) dirname(C) deliver 
log(S) exponential, logarithm, and 
and power functions exp(S} 

dc(C) arbitrary 
monitor (S) 
cpp(CP) the C Language 
unget(CP) undo a 
lock(S) lock a process in 
types (F) 
cal(C) 
yes(C) 
prs(CP) 
date(C) 
sact(CP) 
Hhoami (C) 
pr(C) 

vprlntf(S) vfprintf(S) vsprintf(S) 
printf(S) aprintf(S) fprintf(S) 
banner (C) 
last(C) 
Ipstat(C) 
nia(CP) 
xniii(CP) 
printenv(C) 

accept (C) reject (C) allow/prevent 
pscreen(C) set up terminal to 
files slze(C) 
printers (M) 
strace(n) 
infocmp(M) compare or 



per-process accounting file acct(M) 

perror(S) system error messages perror(S) 

pg(C) file perusal filter pg(C) 

pieces aplittC) 

pipe tee(C) 

pipe to/from a process popen(S) 

pipe(S) create an interprocess channel pipe(S) 

plock(S) lock process, text, or data in _ plock(S) 
plot(S) graphics interface subroutines plot(S) 



point environment control 

point environment control fpgetround(S) 

point environment control 

point environment control fpgetround(S) 
point environment control fpgetround(S) 

point NaN isnan(S) 

pointer in a stream fseek(S) 

pointer 

poll(S) STREAMS input/output 

popen(S) pclose<S) initiate pipe to/fror 

port configuration 

port 

port 



port for a modem 

port name 

port 

port 



portions of pathnames 

power functions exp(S) pow(S) 

pow(S) log(S) exponential, logarithm, 

pr(C) print files on the standard output 

precision calculator 

prepare execution profile 

Preprocessor 



previous get of an SCCS file 
primary memory 



primitive system data types 
print a calendar 



print a string repeatedly 

print an SCCS file 

print and set the date 



f pgetround( S ) 

f pgetround ( S ) 

fpgetround(S) 

f pgetround( S ) 

f pgetroundc S ) 

isnanCS) 

fseek(S) 

Iseek(S) 

poll(S) 

popen ( S ) 

pconf ig(C) 

di3able(C) 

enable(C) 

setmodem(C) 

tty(C) 

attyCC) 

xttylC) 

basename(C) 

exp(S) 

exp(S) 

pr(C) 

dc(C) 

monitor (S) 
. cpp(CP) 
unget(CP) 
lock(S) 
types (F) 
cal(C) 
yes(C) 
prs(CP) 
date(C) 



print current SCCS file edit activity sact(CP) 

print effective current user id whoami(C) 

print files on the standard output pr(C) 

print formatted output of varargs list vprintf(S) 

print formatted output printf(S) 

print large letters banner(C) 

last(C) 
Ipstat (C) 
nm(CP) 



print last record of user logins 

print LP status information 

print name list of common object file 



print 



list 



print out the environment 

print requests 

print screen display 



print section sizes of common object 

print spooler configuration file 

print STREAMS trace messages 

print terminfo descriptions 



xnm(CP) 
printenv(C) 
accept (C) 
pscreen (C) 
3lze(C) 
printers(M) 
atrace(M) 
intocmp(M) 
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unajne(C) 
head(C) 
id(C) 
pw<l(C) 

atrlngB(C) find the 

Ipd(H) line 
xpd(M) transparent 
filter files for printing on LaserJet 
send/cancel requests to LP line 
setinode(C) 
turn on/off line 
Ipr(C) route named files to 
Ipdisable(C) enable/disable LP line 
Ipinit(M) add new line 
file 

formatted output 
hplp(C) hplpR(C) filter filea for 
nice(C) run a command at a different 
nice(S) change 
brc(M) system initialization 
acct(S) enable or disable 
alarm(S) set a 
times(S) get 
init{M) 
exit(S) terminate 
fork(S) create a new 
getpid(S) get process, 
8etpgrp(S) set 
setpgrp(C) execute coomand in a new 
get process, process group, and parent 
lock(S) lock a 
kill(C) terminate a 
nice(S) change priority of a 
kill(S) send a signal to a 
pclo8e(S) initiate pipe to/from a 
process IDs getpid(S) get 
ps(C) report 
plock(S) lock 
times (S) get process and child 
wait(S) wait for child 
ptrace(S) 
pause ( S ) suspend 
checklist (H) list file systems 
inittab(N) script for the Init 
killall(C) kill all active 
send a signal to a process or a group of 
fu8er(M) identify 
wait(C) wait conpletion of background 
awk(C) pattern scanning and 
nawk(C) pattern scanning and 
m4(CP) invoke a macro 
list (CP) 



prof (CP) display 
monitor (S) prepare execution 



print the current UNIX infomation 

print the first few lines of a stream 

print user and group ID and names 

print working directory name 

printable strings in an object file 

printenv(C) print out the environment 

printer daemon 

printer daemon 



printer hplp(C) hplpR(C) 
printer lp(C) cancel(C) 

printer modes utility 

printer scheduler 

printer spooler 

printers Ipenable(C) 

printers 



printers (M) print spooler configuration 

printf(S) sprlntf(S) fprintf(S) print 

printing on LaserJet printer 

priority 



priority of a process 
procedure 



process accounting 

process alarm clock 

process and child process times 
process control initialization _ 

process 

process 



!(C) 

head(C) 

id(C) 

pwd(C) 

strings (C) 

printenv(C) 

Ipd(M) 

xpd(M) 

hplp(C) 

lp(C) 

3etmode(C) 

Ipon(M) 

Ipr(C) 

Ipenable(C) 

Ipinlt(M) 

printers (M) 

print f(S) 

hplp(C) 

nice(C) 

nice(S) 

brc(M) 

acct(S) 

alarm(S) 

times(S) 

init(M) 

exit(S) 

fork(S) 



process group, and parent process IDs getpld(S) 



process group id 
process group 



process IDs getpld(S) 

process in primary memory 

process 

process 



process or a group of processes _ 

process popen(S) 

process, process group, and paren 

process status 

process, text, or data In memory 
process times 



process to stop or terminate 
process trace 



process until signal 

processed by fsck 

processes 

processes 



processes kllKS) 

processes using a file or file structure 
processes ^ 



processing language 
processing language 
processor 



setpgrp(S) 

setpgrp(C) 

getpid(S) 

lock(S) 

kill(C) 

nlce(S) 

kill(S) 

popen ( S ) 

getpid(S) 

pa(C) 

plock(S) 

times (S) 

walt(S) 

ptrace(S) 

pause(S) 

checklist (M) 

inlttab(M) 

klllall(C) 

kill(S) 

fuser (M) 

walt(C) 

awk(C) 

nawk(C) 

m4(CP) 



produce C source listing from COFF file _ list (CP) 

prof(CP) display profile data prof (CP) 

prof (F) profile within a function prof (F) 

profile data prof (CP) 

profile ^ monitor (S) 
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prof 11 (S) execution time 
prof (F) 
time 

aaaert(S) verify 
boot(H) boot 
cxref(CP) generate C 
ctrace(CP) C 
edata{S) etext(S) last locations in 
tapeutll(C) utility 
uuclco(M) file transport 
default (M) default 
sulogln(N) special login 
3trclean(M) STREAMS error logger cleanup 
ua(C) user administration 
scheduler for the uucp file transport 
locate source, binary, or manual for 
cb(CP) beautify C 
lex(CP) generate 
update, and regenerate groups of 
xref(CP) cross-reference C 
xstr(CP) extract strings from C 
clock (H) 
labellt(C) 



screen display 
drand48(S) erand48(S) generate 
nrand48(S) lrand48(S) generate 
seed48(S) srand48(S) jrand48(S) generate 

uuto(C) uuplck(C) 
adb(C) invoke x.out general 
ungetc(S) 
puts(S) fputs(S) 
putc(S) putchar(S) putH(S) fputc(S) 
getdent8(S) read directory entries and 
character or word on a stream putc(S) 
character or vori on a stream 
environment 



stream 

on a stream putc(S) putchar(S) 
file 



msgaet(S) get message 
Ipcm(C) remove message 
qsort(S) 

run a command immune to hangups and 

ranlib(CP) convert archives to 
randon(C) generate a 



profile within a function 



profil(S) 
prof (F) 



profile(M) set up environment at login profile(M) 

protil(S) execution time profile 

program assertion 

program 



program cross-reference 

program debugger 

program end(S) 



program for a streaming tape drive 

program for uucp system 

program Information directory 

program invoked by Init 

program 

program 



program uusched(M) 
program wherels(C) 
programs 



programs for lexical analysis 

programs make(C) maintain. 

programs 

programs 



provide access to the tlme-of-day chip 

provide labels for file systems 

prs(CP) print an SCCS file 

ps(C) report process status 



pscreen(C> set up terminal to print 
pseudo-random numbers 



rand(S) srand(S) simple 



prof 11 (S) 
assert (S) 
boot(M) 
cxref (CP) 
ctrace(CP) 
end(S) 
tapeutil(C) 
uucico(H) 
default (M) 
»ulogin(M) 
strclean(M) 
ua(C) 

uusched(M) 
whereis(C) 
cb(CP) 
lex(CP) 
make(C) 
xref (CP) 
X8tr(CP) 
clock (M) 
labellt(C) 
prs(CP) 
ps(C) 

p8creen(C) 
drand48(S) 
drand48(S) 
drand48(S) 
ptrace(S) 
uuto(C) 
adb(C) 
ungetc(S) 
puts(S) 
putc(S) 
getdents(S) 
putc(S) 
_ putc(S) 

putenv(S) 

putmsg(S) send a massage on a stream putmsg(S) 

putpwent(S) mite password file entry putpwent(S) 

puts(S) fputs(S) put a string on a puts(S) 

putw(S) fputc(S) put character or word putc(S) 

pwck(M) grpck(M) check password/group pwck(M) 

pwd(C) print working directory name pwd(C) 

qsort(S) quicker sort qsort(S) 

query terminfo database tput(C) 

queue msgget(S) 

queue, semphore set, shared memory id Ipcrm(C) 

quicker sort qsort(S) 

quits nohup(C) nohup(C) 

quot(C) sunraarize file system ownership _ quot(C) 

random libraries ranlib(CP) 

random number random (C) 

random (C) 
rand(S) 



pseudo-random numbers /mrand48(S) 
pseudo-random numbers drand48(S) 
ptrace(S) process trace 



public UNIX-to-UNIX system file copy 
purpose debugger 



push character back into input stream 
put a string on a stream 



put character or word on a stream 
put in a file 



putchar(S) putw(S) fputc(S) put 

putc(S) putchar(S) putw(S) fputc(S) put 
putenv(S) change or add value to 



random (C) generate a random number 
random-number generator 
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generator 
libraries 
faplit(CP) split 
standard FORTRAN 
ratfor(CP) convert 
system 
environment 
to be read 
getpas(S) 
COFF file Idtbread(S) 
a COFF file Idshread(S) 
getdents(S) 
read(S) 
line(C) 

check to see if there is data to be 
an archive file Idahread(S) 
Idfhread(S) 

operations directory(S) telldir(S) 
Idaopen(S) open a common object file for 
open(S) open for 

Iseek(S) move 

locking(S) lock/unlock a file region for 
getuid(S) getegid(S) get 
getuid(S) geteuid(S) get 
getuid(S) getgid(S) get 
malloc(S) free(S) 
autoreboot (C) automatically 
reboot (C) automatically 
shutdn(S) reboot (S) shutdown or 
system 
ahutdn(S) 

signal (S) specify what to do on 
lockf (S) 
laat(C) print last 
script (C) make a 
frec(M) 
system from tape 
ed(C) 



make(C) maintain, update, and 
match routines 
match routines 

exec8eg(S) make a data 
locking(S) lock/unlock a file 
regexp(S) compile 
routines regexp(F) 
search file for pattern using full 
regcmp<S) compile a 
regex(S) execute a 
regcmp(CP) compile 
accept (C) 
lorder(CP) find ordering 
Joln(C) Join two 
COFF file Idraeek(S) seek to 



rand(S) srand(S) simple randon-number rand(S) 

ranlib(CP) convert archives to random raniib(CP) 

ratfor files tsplit(CP) 

rat for (CP) convert rational FORTRAN to rat for (CP) 

rational FORTRAN to standard FORTRAN ratfor(CP) 

rcO(M) commands to stop the operating rcO(M) 

rc2(M) commands for multi-user rc2(M) 

rdchk(S) check to see if there is data rdchk(S) 

read a password getpas(S) 

read an indexed symbol table entry of a _ Idtbread(S) 
read an indexed/named section header of _ Idshread(S) 
read directory entries and put in a file getdents(S) 
read from file 



read one line of input 

read rdchk(S) 

read the archive header of a member of 

read the file header of a COFF file 

readdir(S) opendir(S) directory 

reading Idopen(S) 

reading or writing 

read(S) read from file 

read/write tile pointer 

read/write 



real/effective user or group IDs 

real/effective user or group IDs 

real/effective user or group IDs 

realloc(S) fast main memory allocator 

reboot the system 

reboot the system 

reboot the system 



reboot (C) automatically reboot the 

reboot (S) shutdown or reboot the system 

receipt of signal 

record locking on files 

record of user logins 



record of your terminal session 

recover files from a back-up tape 

recover(C) restore contents of a file 
red(C) invoke the ed text editor 



regcmp(CP) compile regular expressions 
regcmp(S) compile a regular expression 
regenerate groups of programs 



regexp(F) regular expression compile and 
regexp(S) compile regular expression and 

regex(S) execute a regular expression 

region executable 

region for read/write 



regular expression and match routines 
regular expression compile and match 

regular expression egrep(C) 

regular expression 

regular expression 

regular expressions 



reject (C) allow/prevent print requests 

relation for object library 

relations 

relocation entries of a section of a 



read(S) 
line(C) 
rdchk(S) 
Idahread(S) 
Idfhread(S) 
directory (S) 
Idopen(S) 
open { S ) 
read(S) 
Iseek(S) 
locking(S) 
getuid(S) 
getuid(S) 
getuid(S) 
malloc(S) 
autoreboot (C) 
reboot (C) 
shutdn(S) 
reboot (C) 
shutdn(S) 
signal(S) 
lockf (S) 
last(C) 
script (C) 
frec(M) 
recover ( C ) 
. ed(C) 
regcmp(CP) 
regcmp ( S ) 
make(C) 
regexp(F) 
regexp ( S ) 
regex(S) 
execseg(S) 
locking(S) 
regexp (S) 
regexp (F) 
egrep(C) 
regcmp (S) 
regex(S) 
regcmp ( CP ) 
accept (C) 
lorder(CP) 
Join(C) 
Idrseek(S) 
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object file reloc(F) 
common object file 
leave(C) 
calendar(C) invoke a 
uuxqt(M) execute 
uutry(M) contact 
ct(C) spavm getty to a 
uux(C) execute command on 
rmdel(CP) 
nndir(S) 
««p(C) 
unlink (S) 
rm(C) rmdlr(C) 
shared memory id ipcnii(C) 
COFF file »trip(CP) 
mv(C) move 
fsck(C) dfsck(C) check and 
uniq(C) report 
ye8(C) print a string 
clock (S) 
fsstat(M) 
fainfo(H) 
facilities status ipcs(C) 
inodes df(H) 
sar(C) system activity 
sar(M) system activity 
ps(C) 
uniq(C) 

Caeek(S) ftell(S) reHind(S) 
Ipsched(H) Ipshut(H) start/stop the LP 
accept (C) reject (C) allow/prevent print 
Ipsched(M) Ipmove(M) move LP 
sysaltos(S) manufacturer specific system 
lp(C) cancel(C) send/cancel 
uuxqt (M) execute remote command 
reset (C) 

Identify device name on which files 
wait and check access to semaphore 
restore. hd(C) 
tape recover (C) 
tape 

table entry Idoetnaaa(S) 
stat(F) 
abs(S) 
logname(S) 
getenv(S) 
false (C) 
true(C) 

rev(C) 

operations directory(S) clo8edlr(S) 
stream fseek(S) ftell(S) 
creat(S) create a new file or 
directories 
uucp link 
file 



relocation of information for a comnon reloc(F) 

reloc(F) relocation of information for a reXoc(F) 

remind you when you have to leave 

reminder service 



remote command requests 

remote system with debugging on 

remote terminal 

remote UNIX 



remove a delta from an SCCS file 

remove a directory 

remove consecutive blank lines 

remove directory entry 



remove files or directories 

remove message queue, semphore set. _ 
remove symbols and line numbers from 

(rename) files and directories 

repair file systems 

repeated lines in a file 

repeatedly 



leave (C) 
caiendar(C) 
uuxqt (M) 
uutry (M) 
ct(C) 
uux(C) 
rmdel(CP) 
rmdir(S) 
asp(C) 
unlink(S) 
rm(C) 
ipcrm(C) 
strip(CP) 
mv(C) 
fsck(C) 
uniq(C) 
yes(C) 
clock(S) 
fBBtat(M) 
fsinto(M) 
ipcs(C) 
df (M) 
sar(C) 
sar(M) 
ps(C) 
uniq(C) 
fseek(S) 
Ipsched(M) 
accept (C) 
Ipsched(M) 
sysaltos(S) 
lp(C) 
uuxqt (M) 
reset (C) 
reset (C) 
devnm(C) 
waitsem(S) 
restore. hd(C) 

restore contents of a file system from recover(C) 

restore. hd(C} restore a hard disk from restore. hd(C) 



report CPU time used 

report file system status 

report information about a file system 

report inter-process communication 



report number of free disk blocks and 

report package 

report package 

report process status 



report repeated lines in a file 

reposition a file pointer in a stream 

request scheduler 

requests 

requests 

requests 

requests to LP line printer 

requests 

reset the teletype bit 

reset (C) reset the teletype bit 

reside devnn(C) 

resource waitsesi(S) nbwaitsem(S) 

restore a hard disk from tape 



retrieve symbol name for COFF symbol 

return data by stat system call 

return integer absolute value 

return login naam of user 



return value for environment name 
return with a nonzero exit value 

return with a zero exit value 

rev(C) reverse lines of a file 

reverse lines of a file 



rewinddir(S) seekdir(S) directory 

rewind(S) reposition a file pointer in a 
rewrite an existing one 



rm(C) rmdlr(C) remove files or 
rmaiKC) receives mail from 



rmdel(CF) remove a delta from an SCCS 



Idgetname(S) 

stat(F) 

abs(S) 

logname(S) 

getenv(S) 

false(C) 

true(C) 

rev(C) 

rev(C) 

directory (S) 

fseek(S) 

creat(S) 

rm(C) 

rmaiKC) 

rmdel(CP) 
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chroot(S) change 
chroot(C) change 
exponential, logarithm, and square 
Ipr(C) 

Idfcn(F) cofimon object tile access 
regular expression compile and match 
compile regular expression and match 
interpreter sh(C) 
nlce(C) 
quits nohup(C) 
activity 
system activity 



archive (C) 
allocation brk(S) 
bfs(C) 
formatted input 
awk(C) pattern 
nawk(C) pattern 
cdc(CF) change the delta commentary of 
comb (CP) combine 
delta(CP) make a change to an 
sact(CP) print current 
get (CP) get a version of an 
prs(CP) print an 
rmdel(CP) remove a delta from an 
sccsdiff(CP) compare two versions of an 
scc8file(F) format of an 
unget(CP) undo a previous get of an 
val(CP) validate an 
admin(CP) create and administer 
sees file 

turn on/off 

ckbupscd(N) check file system backup 
turn on/off 
program uusched(N) 
Ipshut(M) start/stop the LP request 
object file 
image file 
more(C) view a file one full 
clear (C) clear terminal 
pscreen(C) set up terminal to print 
curses (S) terminal 
scr_dump(F) format of curses 
vl(C) invoke a 
inittab(M) 
session 

to a shared data segment 
data segment sdget(S) 
shared data segment 
data access 



rmdir(C) remove files or directories 

rmdir(S) remove a directory 

root directory 



root directory for command 

root functions exp(S) sqrt(S) 

route named files to printer spooler 
routines 



routines regexp(F) 

routines regexp(S) 

rsh(C) invoke the shell command 

run a comnand at a different priority 

run a command immune to hangups and 

sact(CP) print current SCCS file edit 

sadcon(M) data collector 

8ar(C) system activity report package 

sar(M) system activity report package 

save a file system to a streaming tape 

sbrk(S) change data segment space 

scan big files 

scanf(S) fscanf(S) aacanf(S) convert 

scanning and processing language 

scanning and processing language 

SCCS delta 

SCCS deltas 

SCCS file 



SCCS file edit activity 

SCCS file 

SCCS file 

SCCS file 

SCCS file 

SCCS tile 

SCCS file 

SCCS file 

SCCS files 



sccsdlft(CP) compare two versions of an 

sccsfile(F) format of an SCCS tile 

scheduler for line printer 

schedule 

scheduler for line printer 



scheduler for the uucp file transport 

scheduler Ipsched(M) 

scnhdr(F) section header for a common 

scr_dump(F) format of curses screen 

screen at a time 

screen 

screen display 

screen handling and optimization package 
screen image file 



screen-oriented display editor 

script for the init processes 

script (C) make a record of your terminal 
sdb(e) symbolic debugger 



sdenter(S) sdleave(S) synchronize access 

sdfree(S) attach and detach a shared 

sdget(S) sdfree(S) attach and detach a 

Bdgetv(S) sdwaitv(S) synchronize shared _ 
sdlff (C) compare files slde-by-side 



rm(C) 

rmdir(S) 

chroot(S) 

chroot (C) 

exp(S) 

Ipr(C) 

Idfcn(F) 

regexp(F) 

regexp ( S ) 

sh(C) 

nice(C) 

nohup(C) 

sact(CP) 

sadcon(M) 

sar(C) 

sar(M) 

archive (C) 

brk(S) 

bfa(C) 

scant (S) 

awk(C) 

nawk(C) 

cdc(CP) 

comb (CP) 

delta (CP) 

sect (CP) 

get (CP) 

prs(CP) 

rmdel(CP) 

Bccsdlf f (CP) 

sccsfile(F) 

unget(CP) 

val(CP) 

admin (CP) 

sccsdiff (CP) 

8cc8file(F) 

Ipon(M) 

ckbupscd(M) 

Ipon(M) 

uuached(M) 

Ipsched(M) 

scnhdr(F) 

8cr_dump(F) 

more(C) 

clear(C) 

pscreen(C) 

curses (S) 

scr_dump(F) 

vKC) 

inittab(M) 
script (C) 
sdb(C) 
sdenter(S) 
sdget(S) 
sdget(S) 
sdgetv(S) 
sdiff (C) 



PI-41 



Permuted Index 



shared data sagnant adenter(S) 
access sdgetv(S) 
fgrepCC) 
grep(C) 

Isaarch(S) Iflnd(S) linear 
regular expression egrep(C) 
bsearch(S) binary 
hdestroyCS) hcraate(S) manage hash 
tdelete(S) twallc(S) manage binary 
enroll(C) xaend(C) xget(C) 
acnhdr(F) 

ld3hread(S) read an Indexed/named 
manipulate the object file ccMiment 
seek to line number entries of a 
seek to relocation entries of a 
slze(C) print 
add new bad sectors to the bad 
badblock(C) add new bad 



pseudo-randoffl numbers drand48(S) 
of a COFF file Idlseek(S) 
of a COFF file Idrseek(S) 
common object Idohseek(S) 
Idtbseek(S) 

directory (S) closedlr(S) rewlnddlr(S) 
shmget(S) get shared memory 
synchronize access to a shared data 
attach and detach a shared data 
brk(S) sbrk(S) change data 
dump (CP) dump 
hdr(C) display 
files comn(C) 
semctl(S) 

creatsen(S) create a binary 
openseiii(S) open a 
semop ( S ) 

nbwaltsem(S) wait and check access to 
senget(S) get set of 



Ipcrm(C) remve message queue, 
putiiag(S) 
processes klll(S) 
lp(C) cancel (C) 
mesg(C) allow or disallow nessages 
calendar(C) invoke a resdnder 
script (C) make a record of your terminal 
alam(S) 
lunask(S) 

ascll(H) map of the ASCII character 
tlmezone(M) 
env(C) 
utlme(S) 
umask(C) 

log In nunusers(S) get and 



sdlaave(S) synchronize access to a 

sdHaltv(S) synchronize shared data 

search a file tor a character string 

search a file for a pattern 

search and update 



search file for pattern using full 

search of a sorted table 

search tables hsearch(S) 



search trees tsearch(S) tflnd(S) 
secret mall 



section header for a common object file 

section header of a COFF tile 

section mcs(CP) 



section of a COFF file Idlseek(S) 

section of a COFF file Idrseek(S) 

section sizes of common object tiles 
sector map badblock(C) 



sectors to the bad sector map 

sed(C) Invoke the stream editor 
see(C) display a file 



seed48(S) srand48(S) jrand48(S) generate 
seek to line number entries of a section 
seek to relocation entries of a section 

seek to the optional file header of a 

seek to the symbol table of a COFF tile 

seekdlr(S) directory operations 

segment Identifier 



segment sdenter(S) sdleave(S) 

segment sdget(S) sdtree(S) 

segment space allocation 



selected parts of an object tile 

selected parts of an object file 

select/reject lines connon to two sorted 

semaphore control operations 

semaphore 

semaphore 

semaphore operations 

semaphore resource Haltsem(S) 

semaphores 

semctl(S) semaphore control operations 

semget(S) get set of semaphores 

semop(S) semaphore operations 

semphore set, shared memory id 

send a message on a stream 



send a signal to a process or a group of 
send/cancel requests to LP line printer _ lp(C) 



sdenter(S) 

sdgetv(S) 

farep(C) 

grep(C) 

Isearch(S) 

egrep(C) 

bsearch(S) 

hsearch(S) 

tsearch(S) 

enroll (C) 

scnhdr(F) 

Idshread(S) 

mcs(CP) 

Idlseek(S) 

Idrseek(S) 

8lze(C) 

badblock(C) 

badblock(C) 

sed(C) 

see(C) 

drand48(S) 

Idlseek(S) 

Idrseek ( S ) 

Idohseek ( S ) 

Idtbseek(S) 

directory (S) 

shmget(S) 

sdenter(S) 

sdget(S) 

brk(S) 

dump (CP) 

hdr(C) 

COIMII(C) 

semctl(S) 
creatsem(S) 
opensem ( S ) 
semop ( S ) 
waltsem(S) 
semget ( S ) 
semctl(S) 
semget ( S ) 
semop ( S ) 
Ipcrm(C) 
putmsg(S) 
kill(S) 



sent to a terminal 

service 

session 



mesg(C) 

calendar (C) 

script (C) 

alarm(S) 

umask(S) 

ascii(M) 

tlmezone(M) 

set environment for conmand execution env(C) 

set file access and modification times utlme(S) 

set file-creation mode mask umask(C) 

numuaers(S) 



set a process alarm clock 

set and get file creation mask 

set 

set default system time zone 



set maximum number of users allowed to 
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mKC) 

chroot(S) change 
chroot(C) change 
exponential, logarithm, and square 
Ipr(C) 

Idfcn(F) conmon object tile access 
regular expression compile and match 
compile regular expression and match 
interpreter sh(C) 
nice(C) 
quits nohup(C) 
activity 
system activity 



archive (C) 
allocation brk(S) 
bCs(C) 
formatted input 
awk<C) pattern 
naHk(C) pattern 
cdc(CP) change the delta commentary of 
comb (CP) combine 
delta(CP) make a change to an 
sect (CP) print current 
get (CP) get a version of an 
prs(CP) print an 
rmdel(CP) remove a delta from an 
sccsdiff(CF) compare two versions of an 
sccsfile(F) format of an 
unget(CP) undo a previous get of an 
val(CP) validate an 
admin(CP) create and administer 
sees file 

turn on/off 

ckbupscd(M) check file system backup 
turn on/off 
program uusched(M) 
Ipshut(M) start/stop the LP request 
object file 
image file 
more(C) view a file one full 
clear (C) clear terminal 
pscreen(C) set up tenainal to print 
curses ( S ) terminal 
scr_duBp(F) fomat of curses 
vKC) invoke a 
inittab(M) 
session 

to a shared data segment 
data segment adaet(S) 
shared data segment 
data access 



niidlr(C) remove files or directorie 

rmdlr(S) remove a directory 

root directory 



root directory for command 

root functions exp(S) 8qrt(S) 

route named files to printer spooler 
routines 

routines regexp(F) 

routines regexp(S) 

rsh(e) invoke the shell command 



run a comnand at a different priority 

run a command immune to hangups and 

sect (CP) print current SCCS file edit 

sadcon(M) data collector 

8ar(C) system activity report package 

8ar(M) system activity report package 

save a file system to a streaming tape 

sbrk(S) change data segment apace 

scan big files 



3canf(S) fscanf(S) sscanf(S) convert 

scanning and processing language 

scanning and processing language 

SCCS delta 

sees deltas 

sees file 



SCCS file edit activity 

sees file 

SCCS file 

sees file 

sees file 

SCCS file 

SCCS file 

sees file 

SCCS files 



accsdlff (CP) compare two versions of an 

sccsfile(F) format of an SCCS file 

scheduler for line printer 

schedule 



scheduler for line printer 

scheduler for the uucp file transport 
scheduler Ipsched(H) 



scnhdr(F) section header for a comnon 

scr_dump(F) format of curses screen 

screen at a time 

screen 

screen display 

screen handling and optimization package 
screen image file 



screen-oriented display editor 

script for the init processes 

script (C) make a record of your terminal 
sdb(C) symbolic debugger 



sdenter(S) sdleave(S) synchronize access 

sdfree(S) attach and detach a shared 

sdget(S) sdfree(S) attach and detach a 

sdgetv(S) sdwaitv(S) synchronize shared _ 
sdlff (C) compare files side-by-side 



rm(C) 

rmdir(S) 

chroot(S) 

chroot (C) 

exp(S) 

Ipr(C) 

Idfcn(F) 

regexp(F) 

regexp ( S ) 

sh(e) 

nice(C) 

nohup(C) 

8act(CP) 

aadcon(M) 

aar(e) 

8ar(M) 

archive (C) 

brk(S) 

bf3(C) 

scanf (S) 

awk(e) 

nawk ( C ) 

cdc(CP) 

comb (CP) 

delta(eP) 

8act(CP) 

get (CP) 

prs(CP) 

rmdeKCP) 

sccsdiff (CP) 

sccsf ile(F) 

unget(CP) 

val(CP) 

admin (CP) 

sccsdiff (CP) 

accsfile(F) 

Ipon(M) 

ckbupscd(M) 

Ipon(M) 

uusched(H) 

Ipsched(M) 

scnhdr (F) 

scr_dump ( F ) 

more(C) 

clear(C) 

pscreen(e) 

curses ( S ) 

scr_d\imp(F) 

vi(C) 

inittab(M) 
script (C) 
sdb(C) 
8denter(S) 
sdget(S) 
sdget(S) 
sdgetv ( S ) 
sditt(e) 
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shared data segncnt adenteriS) 
access sdgetv(S) 
fgrepCC) 
arep(C) 

Isearch(S) Iflnd(S) linear 
regular expression egrep(C) 
bsearch(S) binary 
hdestroy(S) hcreata(S) manage hash 
tdelete(S) twalk(S) menage binary 
enroll (C) xsend(C) xget(C) 
8cnhdr(F) 

Idshread(S) read an indexed/named 
manipulate the object file comment 
seek to line number entries of a 
seek to relocation entries of a 
slze(C) print 
add new bad sectors to the bad 
badblock(C) add new bad 



pseudo- random numbers drand48(S) 
of a COFF file Idlseek(S) 
of a COFF file Idrseek(S) 
common object Idohseek(S) 
Idtbseek(S) 

directory(S) closedir(S) rewinddlr(S) 
shmget(S) get shared memory 
synchronize access to a shared data 
attach and detach a shared data 
brk(S) sbrk(S) change data 
dump (CP) dump 
hdr(C) display 
files coinn(C) 
semctl(S) 

creatsem(S) create a binary 
opensem(S) open a 
semop ( S ) 

nbwaitsem(S) wait and check access to 
semget(S) get set of 



Ipcrm(C) reanve message queue. 

putauig(S) 
processes kill(S) 
lp(C) cancel(C) 
mesg(C) allow or disallow messages 
calendar(C) Invoke a reminder 
script (C) make a record of your terminal 
alarm(S) 
umask(S) 

asclKH) map of the ASCII character 
tlmezone(M) 
env(C) 
utlffle(S) 
umask(C) 

log in nunusers(S) get and 



sdleave(S) synchronize access to a 

sdwaltv(S) synchronize shared data 

search a file tor a character string 

search a file for a pattern 

search and update 



search file tor pattern using full 

search of a sorted table 

search tables hsearch(S) 



search trees tsearch(S) tflnd(S) 
secret mail 



section header for a comnon object file 

section header of a COFF file 

section mcs(CP) 



section of a COFF file Idlseek(S) 

section of a COFF file Idrseek(S) 

section sizes of common object files 
sector map badblock(C) 



sectors to the bad sector map 

sed(C) Invoke the stream editor 
see(C) display a file _^ 



seed4S(S) srand48(S) jrand48(S) generate 
seek to line number entries of a section 
seek to relocation entries of a section 

seek to the optional file header of a 

seek to the symbol table of a COFF file 

seekdlr(S) directory operations 

segment Identifier 



segment sdenter(S) sdleave(S) 

segment sdget(S) sdfree(S) 

segment space allocation 



selected parts of an object file 

selected parts of an object file 

select/reject lines conmon to two sorted 

semaphore control operations 

semaphore 

semaphore 

semaphore operations 

semaphore resource waitsem(S) 

semaphores 

semctl(S) semaphore control operations _ 

semget(S) get set of semaphores 

semop(S) semaphore operations 

semphore set, shared memory id 

send a message on a stream 



send a signal to a process or a group of 
send/cancel requests to LP line printer 

sent to a terminal 

service 

session ■ 

set a process alarm clock 

set and get file creation mask 

set 

set default system time zone 

set environment for command execution 

set file access and modification times _ 
set file-creation mode mask 



set maximum number of users allowed to 



sdenter(S) 

sdgetv(S) 

fgrep(C) 

grep(C) 

lsearch(S> 

egrep(C) 

bsearch(S) 

hsearch(S) 

tsearch(S) 

enroll (C) 

scnhdr (F) 

IdshreadCS) 

mcs(CP) 

Idlseek(S) 

Idrseek(S) 

size(C) 

badblock(C) 

badblock(C) 

sed(C) 

see(C) 

drand48(S) 

Idlseek(S) 

Idrseek(S) 

Idohseek(S) 

Idtbseek(S) 

directory (S) 

shmget(S) 

sdenter(S) 

8dget(S) 

brk(S) 

dump(CP) 

hdr(C) 

coami(C) 

semctl(S) 

creatsem(S) 

opensem(S) 

semop (S) 

waltsem(S) 

semget(S) 

semctl(S) 

semget(S) 

semop(S) 

Ipcrm(C) 

putmsg(S) 

klll(S) 

. lp(C) 

_ mesg(C) 
calendar (C) 

. script (C) 
alarm(S) 
umaBk(S) 
ascil(H) 
tlmezone(M) 

_ env(C) 
utlme(S) 
uma8k(C) 

_ numusers(S) 



PI-42 



Permuted Index 



semget(S) get 
pconf lg(C) 
«etpgrp(S) 

ipcrm(C) remove message queue, semphore 
tabs(C) 
getty(M) 
tset(C) 

discipline uugetty(n) 
date(C) print and 
stty(C) 
xtty(C) 
asktime(C) 
stimetS) 
profile(M) 
pscreen(C) 
setiiiodem(C) 
shuttype(S) get and 
setuld(S) 
uliinit(S) get and 
a stream 

getgrent(S) fgetgrent(S) endgrent(S) 



process group 

getpwent(S) tgetpwent(S) endpwent(S) 
modification dates of files 
gettydefs(N) speed and terminal 

file entry getut(S) 
setbuf (S) 
sputl(S) 

adgetv(S) adwaltv(S) synchronize 
sdleave(S) synchronize access to a 
'dget(S) sdfree(S) attach and detach a 
chk8hlib(CF) tool for comparing 
nhshllb(CP) create a 
shnctl(S) 

remove message queue, semphore set. 

shnop ( S ) 
shraget(S) get 
interpreter 
bsh(C) invoke the Business 
sh(C) rsh(C) Invoke the 
syntax csh(C) 
systeai(S) Issue a 
create menu system(8) for the Business 
menus (H) format of Business 

operations 
identifier 

nap(S) suspend execution for a 
the system 
shutype(M) UPS 



set of semaphores 

set port configuration 

set process group id 

shared memory id 



set . 

set tabs on a terminal 

set terminal mode 

set terminal modes 

set terminal type, modes, speed, line 
set the date 



set the options for a port 
set the options for a port 
set the system time of day 
set time 



set up environment at login time 

set up terminal to print screen display 

set up tty port tor a modem 

set UPS shutdown limits 

set user and group IDs 

set user limits 



setbuf(S) setvbuf(S) assign buffering to 

setgrent(S) get group file entry 

setjmp(S) longjmp(S) non-local goto 

setmnt(C) establish /etc/nnttab table __ 
setmode(C) printer modes utility 



8etmodem(C) set up tty port for a modem 

setpgrp(C) execute command in a new 

Betpgrp(S) set process group id 

setpwent(S) get passitord file entry 

settime(C) change the access and 

settings used by getty 



setuld(S) set user and group IDs 



semget(S) 

pconfig(C) 
setpgrp(S) 
ipcrm(C) 
tabs(C) 
getty(M) 
tset(C) 
uugetty (M) 
date(C) 
stty(C) 
xtty(C) 
asktime(C) 
stime(S) 
profile(M) 
pscreen (C) 
setmodem(C) 
»huttype(S) 
aetuld(S) 
ulimit(S) 
setbuf (S) 
getgrent (S) 
8etjmp(S) 
setmnt (C) 
setmode(C) 
setmodem(C) 
setpgrp(C) 
setpgrp(S) 
getpwent (S) 
settlme(C) 
gettydefs(M) 
setuid(S) 
getut(S) 



setutent(S) getutllne(S) access utmp 
setvbuf(S) assign buffering to a stream _ setbuf(S) 



sgetl(S) access long Integer data 
shared data access 



shared data segment sdenter(S) 

shared data segment 

shared libraries 

shared library 



shared memory control operations 

shared memory id Ipcm(C) 

shared memory 



operatic 



shared memory segment identifier 

sh(C) rsh(C) Invoke the shell command 

shell 

shell command interpreter 



sputl(S) 

sdgetv ( S ) 

sdenter(S) 

sdget(S) 

chkshllb(CP) 

mkshlib(CP) 

shmctl(S) 

Ipcrm(C) 

8hmop(S) 

shmget ( S ) 

8h(C) 

b8h(C) 

8h(C) 



shell conmand interpreter with C-like csh(C) 



shell command 

Shell digest (C) 

Shell menu system 

shKC) shell layers 

shmctl(S) shared memory control 

shmget (S) get shared memory segment 

shmop(S) shared memory operations 

short Interval 



shutdn(S) reboot (S) shutdown or reboot 
shutdown configuration utility 



system(S) 
digest (C) 
menus (M) 
shl(C) 
shmctl(S) 
shmget (S) 
shmop ( S ) 
nap(S) 
shutdn(S) 
shutype(H) 
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shuttype(S) get and set UPS 
■hutdn(S) reboot (S) 
bring eystem to alngle-uaer or 
or shutdown 
limits 
utility 

sdlff(C) compare files 
signal manageaient aigaat(S) 
aigset(S) sighold(S) algrelae(S) 
sighold(S) sigrelse(S) siglgnore(5) 
sigset(S) sigpause(S) 
pause(S) suspend process until 
specify what to do on receipt of 
processes kilKS) send a 
of signal 

ssignal(S) gsignal(S) software 
sigset (S) 

management sigset (S) slghold(S) 
3igignore(S) signal management 

rand(S) srand(S) 
fmt(C) 

shutdown (M) bring system to 
multi/single-uaer mode multluser(C) 
functions 

trigonometric functions trig(S) 
chslze(S) change the file 
slzefs(C) detemine the 
object files 
logical disk drive 
size(C) print section 
interval 

user ttyslot(S) find the 
spline(C) interpolate 
intro(CP) introduce 
ssignal(S) gsignal(S) 
tsort(C) 
sort(C) 
qsor t ( S ) quicker 

select/reject lines coaaaon to two 
look(C) find lines In a 
bsaarch(S) binary search of a 
whereis(C) locate 
list (CP) produce C 
create an error Msssge file frosi C 
create an error Mssage file froai C 
tlc(C) compile terminfo 
brk(S) sbrk(S) change data segment 
ct{C) 

■skedevs(H) create 
nakettys(M) create tty 

mknod(C) build 
sulogln(M) 

mknod(S) make a directory, or a 
sysaltos(S) manufacturer 



ahutdown limlta 

shutdown or reboot the system 
shutdown shutdown(M) 



shutdown{N) bring system to single-user 

shuttype(S) get and set UPS shutdown 

shutype(M) UPS shutdown configuration 

side-by-side 



sighold(S) sigrelse(S) sigignore(S) 

slgignore(S) signal management 

aignal management sigset (S) 

signal management 

signal 



ignal signal(S) 



signal to a process or a group of 

signal (S) specify what to do on receipt 

signals 

aigpause(S) signal management 



sigrelse(S) sigignore(S) signal 

aigaat(S) sighold(S) sigrelse(S) 

sigset (S) sigpauae(S) aignal management _ 

aimple random-number generator 

aimple text formatter 

single-user or shutdown 



slngleuser(C) bring system up 

sinh(S) cosh(S) tanh(S) hyperbolic 

sin(S) cos(S) tan(S) aaln(S) acoa(S) 

aize 

size of a logical diak drive 

size(C) print section sizes of comaior 

sizefs(C) detemine the size of a 

sizes of coamon object files 

sleep(C) suspend execution for an 



sleep(S) suspend execution for interval 

slot in the utmp file of the current 

saKWth curves 



software development commands 
software signals 



sort a file topologically 

aort and merge files 

sort 



sort(C) sort and merge files 

aorted files coan(C) 

sorted list 

sorted tsble 



source, blnsry. or manual for program 

source listing from COPF file 

source mkstr(C) 

source mkstr(CP) 

source J 

space allocation 

spawn getty to a reaiote terminal 

special device files 

special files 

special files 



special login program invoked by init 

special or ordinary file 

specific system requests 



shuttype(S) 

shutdn(S) 

shutdown(M) 

ahutdown(M) 

ahuttype(S) 

shutype(M) 

sdiff (C) 

sigset(S) 

slgset(S) 

sig8et(S) 

sigset (S) 

pause(5) 

aignal (S) 

kilKS) 

signal (S) 

ssignal(S) 

sigset(S) 

slgset(S) 

aigBet(S) 

sigaet(S) 

rand(S) 

tnt(C) 

shutdown(M) 

multiuser(C) 

sinh(S) 

trig(S) 

chsize(S) 

sizefs(C) 

si2e(C) 

aizef8(C) 

size(C> 

sleep(C) 

sleep(S) 

ttyslot(S) 
spllne(C) 

intro(CP) 

asignal(S) 

taort(C) 

sort(C) 

qsort (S) 

sort(C) 

coiMn(C) 

look(C) 

bsaarch(S) 

whereis (C) 

list (CP) 

mkstr(C) 

mkstr(CP) 

tic(C) 

brk(S) 

ct(C) 

makedevs(M) 

makettys(M) 

mknod(C) 

sulogln(M) 

mknod(S) 

sysaltos(S) 
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fapec(F) format 
cron(C) execute coomands at 
signal (S) 
getty gettydefs(M) 
uugetty(M) set terminal type, modes, 
find spelling errors 

split (C) 
csplit (C) 
f split (CP) 

uucleanup(M) uucp 
printers (M) print 
Ipr(C) route named files to printer 
Ipadmin(M) configure the LP 
output print f(S) 
data 

square root functions exp(S) 
,sqrt(S) exponential, logarithm, and 
pseudo-random/ drand48(S) seed48(S) 
rand(S) 
scanf(S) fscanf(S) 



stdio(S) 

ratfor(CP) convert rational FORTRAN to 
gets(C) get a string from the 
package stdipc(S) ftok(S) 
pr(C) print files on the 
Ipsched(M) Ipshut(M) 
stat(F) return data by 

information 
ustat(S) get file system 

fsstat(M) report file system 
lp8tat(C) print LP 
fileno(S) clearerr(S) feof(S) stream 
uustat(C) uucp 
inter-process communication facilities 
ps(C) report process 
stat(S) fstat(S) get file 
package 

connunlcation package 

wait(S) wait for child process to 
rcO(M) conmands to 
functions dbnCS) flratkeY(S) 

string operations string(S) 
tring(S) strncmp(S) strcpy(S) Btrlen(S) 
program 

tring(S) strcat(S) strdup(S) strpbrk(S) 
operations strlng(S) strncmp(S) 
operations string(S) 8trcat(S) 
sed(C) invoke the 
fclose(S) fflush(S) close or flush a 



specification in text tiles 

specified times 

specify what to do on receipt of signal 

speed and terminal settings used by 

speed, line discipline 

spell (C) 

spline (C) interpolate smooth curves 

split a file into pieces 



split files according to context 
split ratfor files 



split (C) split a file into pieces 

spool directory cleanup 

spooler configuration file 

spooler 



spooling system 



f spec (F) 

cron(C) 

signal(S) 

gettydefs(H) 

uugetty (M) 

spell (C) 

3pline(C) 

split (C) 

csplit(C) 

fsplit(CP) 

split (C) 

uucleanup(M) 

printers (M) 

Ipr(C) 

Ipadmin(M) 



sprintf(S) fprintf(S) print formatted printf(S) 



sputl(S) sgetl(S) access long integer 

sqrt(S) exponential, logarithm, and 

square root functions exp(S) 

srand48(S) jrand48(S) generate 



srand(S) simple random-number generator 
S3canf(S) convert formatted input 



ssignal(S) gsignaKS) software signals 
8sp(C) remove consecutive blank lines 
standard buffered input/output package 

standard FORTRAN 

standard input 



standard interprocess coimiunication 
standard output 



start/stop the LP request scheduler 
Stat system call 



stat(F) return data by stat system call 

statfs(S) fstatfs(S) get file system 

statistics 

stat(S) fstat(S) get file status 

status 

status information 

status inquiries ferror(S) 

status Inquiry and job control 

status lpc8(C) report 

status 

status 

8tdlo(S) standard buffered input/output 
stdipc(S) ftok(S) standard interprocess 

stiffle(S) set time 

stop or terminate 



stop the operating system 

8tore(S) fetch(S) perform database 

strace(M) print STREAMS trace messages _ 
8trcat(S) strdup(S) strpbrk(S) strcmp(S) 
strchr(S) string operations 



strclean(M) STREAMS error logger cleanup 
stranp(S) string operations 



8trcpy(S) 8trlen(S) 8trchr(S) string 
8trdup(S) 8trpbrk(S) strcmpCS) string 

stream editor 

stream 



sputl(S) 

exp(S) 

exp(S) 

drand48(S) 

rand(S) 

scanf (S) 

s8ignal(S) 

ssp(C) 

stdio(S) 

rat for (CP) 

getsCC) 

stdipc(S) 

pr(C) 

Ipsched(M) 

8tat(F) 

stat(F) 

8tatfs(S) 

ustat(S) 

stat(S) 

fsstat(M) 

IpstatCC) 

f error ( S ) 

uustat(C) 

ipcs(C) 

ps(C) 

stat(S) 

atdio(S) 

stdipc(S) 

stime(S) 

wait(S) 

rcO(M) 

dbm(S) 

strace(M) 

string(S) 

string(S) 

strclean(M) 

string(S) 

string(S) 

string(S) 

sed(C) 

fclose(S) 
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fopen(S) fdopen(S) freopen(S) open a 
rewind(S) reposition a file pointer in a 
getchar(S) get character or word from a 
getinsg(S) get next mesaage oft a 
gets(S) fgets(S) get a atring from a 
head(C) print the firat few linea of a 
fputc(S) put character or word on a 
putinsg(S) send a message on a 
puts(S) fputs(S) put a string on a 
setvbuf(S) assign buffering to a 
ferror(S) tileno(S) clearerr(S) feof(S) 
ungetc(S) push character back into input 
archive(C) save a file system to a 
tapeutil(C) utility program for a 
clone (M) open any minor device on 
strclean(M) 
atrerr(M) 
log(M) interface to 
poll(S) 
strace(M) print 

between long integer and base-64 ASCII 
localtime(S) convert date and time to 
cftime(S) convert date and time to 
ecvt(S) convert floating-point number to 
fgrep(C) search a file for a character 
get8(S) fgets(S) get a 
gets(C) get a 
mkvera(CP) generate a what 
puta(S) fputs(S) put a 
strcat(S) strdup(S) strpbrk(S) strcmp(S) 
3trncmp(S) 8trcpy(S) atrlen(S) strchr(S) 
string(S) atrspnCS) strtokCS) 
yea(C) print a 
strtod(S) atof(S) convert 
atrtoKS) atol(S) atoi(S) convert 
Jt8tr(CP) extract 
strings (C) find the printable 
strcmp(S) string operations 
strchr(S) string operations 
operations 
an object tile 
nunbers tron COFF file 
string(S) atmciapCS) strcpY(S) 
string operations string(S) 
strlng(S) strcat(S) strdup(S) 
strlng(S) 
doubla-preclslon number 
string(S) strspn(S) 
to Integer 

identify processes using a file or tile 
mount(C) uinount(C) mount /unmount a file 

plot(S) graphics interface 
another user 
by inlt 
blocks In a file 



stream tseek(S) ttell(S) 

stream getc(S) getw(S) fgetc(S) 

stream 

stream 

stream 



stream putc(S) putchar(S) putw(S) 

stream 

stream 



atream setbuf(S) 

stream status inquiries 
stream 



streaming tape 

streaming tape drive 
STREAMS driver 



STREAMS error logger cleanup program 

STREAMS error logger daemon 

STREAMS error logging 



STREAMS input/output multiplexing 
STREAMS trace messages 



f open ( S ) 
fseek(S) 
getc(S) 
getmsg(S) 
gets(S) 
head(C) 
putc(S) 
putmsg(S) 
puts(S) 
setbuf (S) 
ferror(S) 
ungetc (S) 
archive (C) 
tapeutil(C) 
clone (M) 
strclean(M) 
strerr(M) 
log(M) 
poll(S) 
straceCM) 
strerr(M) 
a641(S) 
ctime(S) 
ctime(S) 
ecvt(S) 
fgrep(C) 
get8(S) 
get8(C) 
mkvers(CP) 
puts(S) 
strlng(S) 
strlng(S) 
string(S) 
yes(C) 
3trtod(S) 
atrtoKS) 
xstr(CP) 
8trings(C) 
atring(S) 
strlng(S) 
string(S) 
strings (C) 
strip (CP) 
string(S) 
string(S) 
string(S) 
string(S) 
strtod(S) 
string(S) 
strtol(S) 

fu8er(«) 

mount (C) 

stty(C) 

plot(S) 

su(C) make the user a super-user or 8u(C) 

sulogin(M) special login program Invoked sulogin(H) 
suiii(C) calculate checksum and count sum(C) 



strerr(M) STREAMS error logger daemon 

string a641(S) 164a(S) convert 

string ctime(S) gmtime(S) 

string ctime(S) tzset(S) asctime(S) 

string 

string 

string from a stream 

string from the standard input 

string 



string on a stream 

string operations string(S) 
string operations Btrlng(S) 

atring operationa 

string repeatedly 



atring to double-precision number 

string to integer 

strings from C programs 



strings in an object tile 

strlng(S) Btrcat(S) strdup(S) strpbrk(S) 
string(S) strncmp(S) strcpy(S) strlen(S) 

string(S) atrspn(S) strtok(S) string 

strings (C) find the printable strings in 
strip (CP) remove symbols and line 



strlen(S) strchr(S) string operations 

8trncmp(S) strcpy(S) 8trlen(S) strchr(S) 
strpbrk(S) strcmp(S) string operations _ 

strapn(S) strtok(S) string operations 

strtod(S) atot(S) convert string to 

strtok(S) string operations 



atrtoKS) atol(S) atol(S) convert string 

structure fuser(H) 

structure 

8tty(C) set the options for a port 

subroutines 
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du(C) 
quot(C) 
sync(S) update 
sync(C) update the 
su(C) make the user a 
terminals (M) list of 
nap(S) 
sleep(C) 
sleep (S) 
pause(S) 

swab(S) 
swap(C) change 

Idgetname(S) retrieve 
retrieve symbol name for COFF 
Idtbindex(S) compute the index of a 
Idtbread(S) read an indexed 
syms(F) common object tile 
make bootable system file with driver 
make bootable system file with kernel 
Idtbseek(S) seek to the 
unistd(F) file header for 
sdb(C) 
Btrip(CP) remove 
glos3ary(C) define common UNIX terms and 
format 

segment sdenter(S) sdleave(S) 
sdgetv(S) 8dwaitv(S) 

shell command interpreter with C-like 
lint(CP) check C language usage and 
requests 
information 
information 

messages 8ys_nerr(S) 
information 
system error messages 
login (C) give you 
acct(C) accounting 

sar(C) 
sar(M) 

Inir(M) clean the tile 
ckbupacd(M) check tile 
stat(F) return data by stat 
Intro(S) Introduce 
ayacont(C) get 
sy8cont(S) get 
cu(C) call another UNIX 
types (F) primitive 
tsdb(M) file 
sysdet(M) output 
perror ( S ) 

sys_nerr(S) ays_errlist (S) errno(S) 



sunmarize disk usage 

summarize file system ownership 

super block 

super-block 



super-user or another user 
supported terminals 



suspend execution for a short interval 

suspend execution tor an interval 

suspend execution for interval 

suspend process until signal 

swab(S) swap bytes 

swap bytes 



swap device configuration 

swap(C) change swap device configuration 
symbol name tor COFF symbol table entry 
symbol table entry Idgetname(S) 



symbol table entry of a COFF file 
symbol table entry of a COFF file 

symbol table format 

symbol table mkunix(M) 

symbol table mkunix(M) 

symbol table of a COFF tile 

symbolic constants 

symbolic debugger 



du(C) 

quot(C) 

8ync(S) 

aync(C) 

su(C) 

terminals(M) 

nap(S) 

sleeplC) 

sleep(S) 

pause(S) 

swab ( S ) 

swab ( S ) 

swap(C) 

swap(C) 

Idgetname(S) 

Idgetname(S) 

Idtbindex(S) 

Idtbread(S) 

sym3(F) 

mkunix(M) 

mkunix<M) 

Idtbseek(S) 

unistd(F) 

sdb(C) 



symbols and line numbers from COFF file _ strip(CP) 



symbols 

8yms(F) common object file symbol table 
aync(C) update the super-block 



synchronize access to a shared data 

synchronize shared data access 

sync(S) update super block 

syntax csh(C) 

syntax 

sysalto8(S) manufacturer specific system 

sysconf(C) get system configuration 

sysconf(S) get system configuration 

sysdetCM) output system definition 

sys_errllst(S) errno(S) system error 

sysfB(S) get tile system type 

sys_nerr(S) Bys_errllst (S) errno(S) 

system access 

system 

system activity data collection 

system activity report package 

system activity report package 

system and executes init 

system backup schedule 

system call 



system calls, functions, and libraries 

system configuration information 

system configuration information 

system 

system data types 

system debugger 

system definition 

system error messages 

system error messages 



glossary(C) 

syms ( F ) 

sync (C) 

sdenter(S) 

sdgetv(S) 

sync(S) 

csh(C) 

lint (CP) 

sysaltos(S) 

sysconf(C) 

sysconf(S) 

sysdef(M) 

Bys_nerr(S) 

sysfs(S) 

sysnerr(S) 

login (C) 

. acct(C) 
sadcon(M) 
aar(C) 
sar(H) 
inir(M) 
ckbupscd(M) 
stat(F) 
intro(S) 
sysconf(C) 
sysconf(S) 

. cu(C) 

_ types (F) 

. fsdb(M) 

. sysdef(M) 
perror (S) 
sys_nerr(S) 
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uuto(C) uupiclc(C) public UNIX-to-UNIX 
mkunix(M) make bootable 
mkunix(M) make bootable 
recover(C) restore contents of a tile 
report information about a file 
help(C) 

fstYp(M) determine the file 
iJirent(F) file 
statfsCS) fatatfs(S) get tile 
brc (M) 

Ipadmin(M) configure the LP spooling 
mail(C) 

menus(M) format of Business Shell menu 
mkfs(M) construct a file 
raount(S) mount a tile 
quot(C) sujTunarize file 
rcO(M) commands to stop the operating 
reboot (C) automatically reboot the 
sysaltos(S) manufacturer specific 
reboot (S) shutdown or reboot the 
ustat(S) get file 
fsstat(M) report file 
fstab(M) file 
mnttab{M) mounted file 
asktime(C) set the 
timezone(M) set default 
archive(C) save a tile 
shutdown (M) bring 
sysfsCS) get tile 
uname(S) get name of current UNIX 
multiuser(C) aingleuserfC) bring 
file transport program for uucp 
f ilesystem(M) format of a 
who(C) display who is on the 
uutry(M) contact remote 
volcopy(M) labelit(M) copy tile 
haltsys(C) close the file 
digest (C) create menu 
fsck(C) dfsck(C) check and repair file 

labelit(C) provide labels for file 
umountall(C) mount /unmount multiple file 
checklist (M) list file 
bsearch(S) binary search of a sorted 
retrieve symbol name for COFF symbol 
compute the Index of a symbol 
Idtbread(S) read an indexed symbol 
syms(F) coMnon object file symbol 
fatab(n) file system 
bootable system file with driver symbol 
bootable system file with kernel symbol 
mnttab(N) mounted file system 
Idtbseek(S) seek to the symbol 
setmnt(C) establish /etc/mnttab 
hcreate(S) manage hash search 
tab8(C) set 



system file copy 

system tile with dri 



able 



er symbol 

system file with kernel symbol table 

system from tape 

system fsinfo(M) 

system help facility 

system identifier 



system independent directory entry 

system information 

itializ 



system 

system 

system mail 

system 

system 

system 

system ownership 

system 

sy s t em 



procedur 



system requests 

system shutdn(S) 

system statistics 

system status 

system table 

system table 

system time of day 
system time zone 



system to a streaming tape 

system to single-user or shutdown 

system type information 

system 



system up multi/single-user mode 

system uucico(M) 

system volume 

system 



system with debugging on 

system with label checking 
systems and halt the CPU 



system(s) for the Business Shell 
systems 



system(S) issue a shell comnand 
systems 



systems mountall(C) 

systems processed by fsck 
table 



table entry Idgetname(S) 

table entry of a COFF file Idtbindex(S) 

table entry of a COFF file 

table format 

table 



table mkunix(M) make 
table mkunix(M) make 
table 



table of a COFF file 
table 



tables hsearch(S) hdestroyCS) 

tabs on a terminal 

tabs(C) set tabs on a terminal 



recover (C) 

tslnto(M) 

help(C) 

tstYp(M) 

dirent (F) 

statf s(S) 

brcCM) 

Ipadmin(M) 

mail(C) 

menus (M) 

mkfs(M) 

mount (S) 

quot (C) 

rcO(M) 

reboot (C) 

sysaltosCS) 

shutdn(S) 

ustat(S) 

tsstat (N) 

fstab(M) 

mnttab(M) 

asktime(C) 

timezone(M) 

archive(C) 

shutdown(M) 

ayafs(S) 

uname(S) 

multiuser(C) 

uucico(M) 

filesystem(M) 

who(C) 

uutry(M) 

volcopy(M) 

haltsys(C) 

digest(C) 

fsck(C) 

system(S) 

labelit(C) 
mountain C) 
checklist (M) 
bsearch(S) 

Idgetname(S) 

Idtbindex(S) 

Idtbread(S) 

syms ( F ) 

fatab(M) 

mkunix(M) 

mkunix(M) 

mnttab(M) 

ldtb8eek(S) 

setmnt(C) 

hsearch(S) 

tab8(C) 

tabs(C) 
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ctags(C) create a tags file 



■Inh(S) coah(S) 
functions trig(S) sin(S) coa(S) 
save a file aystan to a straainlng 
utility prograai tor a streaming 
dump contents of a hard disk to 
frec(M) recover files froa a back-up 
restore contents of a file system from 
restore. hd(C) restore a hard disk from 
streaming tape drive 

trees tsearch(S) tflnd(S) 
tee(C) create a 

tk(C) paginator for 
reset (C) reset the 
directory operations dlrectory(S) 
file tmpnam(S) 
tmpflle(S) create a 
tmpnam(S) tempnam(S) create a name tor a 
captoinfo(M) convert 

termcap(M) 
terminfo(N) 
ct(C) spawn getty to a remote 
ctermid(S) generate file name for 
termlo(M) general 
dial(S) establish an out-going 
virtual 

allow or disallow messages sent to a 
getty(M) set 
tset(C) set 
clear(C) clear 
optimization package curses (S) 
script (C) make a record of your 
gettydets(M) speed and 
tabs(C) set tabs on a 
pscreen(C) set up 
ttyname(S) isatty(S) find name of a 
discipline uugetty(M) set 
ttysCH) login 
terminals (M) list of supported 
term(M) conventional names for 

kilKC) 
errstop(C) 
exlt(S) 

wait for child process to stop or 
query 

captolnfo(H) convert termcap to 
intocmp(M) compare or print 
tic(C) compile 



glossary (C) define coniion UNIX 



Btric 



tall(C) deliver the last part of a file 

tanh(S) hyperbolic functions 

tan(S) asin(S) acos(S) trigone 

tape archive (C) 

tape drive tapeutil(C) 

tape dunp.hd(C) 

tape 

tape recover(C) 

tape 



tapeutil(C) utility program for a 
tar(C) archive files 



tdelete(S) twalk(S) manage binary search 
tee in a pipe 



tee(C) create a tee in a pipe 

Tektronix 4014 

teletype bit 



telldir(S) readdir(S) opendlr(S) 

tempnam(S) create a name for a temporary 

temporary file 

temporary file 



termcap to terminfo description 

termcap(M) terminal capability database 

terminal capability database 

terminal capability database 

terminal 

terminal 

terminal Interface 

terminal line connection 

terminal management 

terminal mesg(C) 

terminal mode 

terminal modes 



terminal screen 

terminal screen handling and 
terminal session 



terminal settings used by getty 
terminal 



speed, line 



terminal to print screen display 

terminal 

terminal type, modes. 

terminals file 

terminals 

terminals 



terminals (M) list of supported terminals 
terminate a process 



terminate error- logging demon 

terminate process 

terminate Halt(S) 

terminfo database 

terminto description 

terminfo descriptions 

terminfo source 



terminfo (H) terminal capability database 

termio(M) general terminal interface 

tem(N) conventional names for terminals 
terms and symbols 



ctags(C) 

tail(C) 

slnh(S) 

trig(S) 

archive(C) 

tapeutil(C) 

dump. hd(C) 

trec(H) 

recover ( C ) 

restore. hd(C) 

tapeutlKC) 

tar(C) 

tsearch(S) 

tee(C) 

tee(C) 

tk(C) 

reset (C) 

directorY(S) 

tmpnaiir< S ) 

tmpfile(S) 

tmpnam ( S ) 

captoinfo(M) 

termcap(M) 

termcap(M) 

terminfo(M) 

ct(C) 

ctermid(S) 

termlo(M) 

dial(S) 

vt(M) 

mesg(C) 

getty(H) 

tset(C) 

clear(C) 

curses (S) 

script (C) 

gftttydets(M) 

taha(C) 

pscreen(C) 

ttyname(S) 

uugetty(H) 

ttys(M> 

terminals (M) 

terrnlM) 

terminals (M) 

kill(C) 

errstop(C) 

exit(S) 

Halt(S) 

tput(C) 

captoinfo(M) 

infocmp(M) 

tic(C) 

terminto(M) 

termlo(M) 

term(M) 

glossary (C) 
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isnan(S) isnanf(S) isnand(S) test for floating point NaN 



ed(C) red(C) invoke the ed 
edlt(C) invoke the edit 
ex(C) invoke a 
diff(C) compare two 
fspec(F) format specification in 
fmt(C) simple 
plock(S) lock process, 
binary search trees tsearch(S) 



clock (M) provide access to the 
cron(C) execute commands at specified 

touch (C) update access and modification 
times(S) get process and child process 
set file access and modification 
times 



temporary file 
characters conv(S) toupper(S) 
popen(S) pclose(S> initiate pipe 
conv(S) toupper(S) toascil(S) 
chkshlib(CP) 
tsort(C) sort a file 
times of a file 
translate characters conv(S) 
query termlnfo database 

atrace(M) print STREAMS 
ptrace(S) process 
aftp(C) 

conv(S) toupper(S) toascil(S) tolower(S) 

tr(C) 
xpd(M) 
uuclco(H) file 
uusched(M) scheduler for the uucp file 

ftw(S) walk a file 
tdelete(S) twalk(S) manage binary search 
trig(S) atan(S) atan2(S) 
8ln(S) cos(S) tan(S) asln(S) acos(S) 
functions 

acos(S) trlgononetric functions 
manage binary search trees 



8etmodem(C) set up 
makettys(H) create 



terminal 

file of the current user 



teat(C) evaluate an expression 

text editor 

text editor 

text editor 

text files 

text files 



text formatter 

text, or data in memory 

tfind(S) tdelete(S) twalk(S) manage 

tic(C) compile termlnfo source 

time(C) time a command 

time-of-day chip 

times 

time(S) get time 

times of a file 

times 



times utime(S) 

times (S) get process and child process _ 
timezone(N) set default system time zone 

tk(C) paginator for Tektronix 4014 

trapflle(S) create a temporary file 



tmpnam(S) tempnaffl(S) create a name for a 

toascll(S) tolower(S) translate 

to/from a process 



tolower(S) translate characters 

tool for comparing shared libraries 

topologically 

touch (C) update 



access and modification 

toupper(S) toascll(S) tolower(S) 

tput(C) 

tra(C) copy out a file as it grows 

trace messages 

trace 

transfer files between Altos machines 

translate characters 

translate characters 



transparent printer daemon 

transport program for uucp system 
transport program 



tr(C) translate characters 
tree 



trees tsearch(S) tfind(S) 
trigonometric functions 



isnan(S) 

test (C) 

ed(C) 

edit(C) 

ex(C) 

dlff (C) 

fspec(F) 

fmt(C) 

plock(S) 

tsearch(S) 

tic(C) 

time(C) 

clock (M) 

cron(C) 

time(S) 

touch(C) 

times (S) 

utime(S) 

tinies(S) 

tlmezone(M) 

tk(C) 

tmpfile(S) 
tmpnam ( S ) 
conv ( S ) 
popen ( S ) 
conv ( S ) 
chk8hlib(CP) 
tsort(C) 
touch (C) 
conv(S) 
tput(C) 
tra(C) 
strace(M) 
ptrace(S) 
aftp(C) 
conv(S) 
. tr(C) 
xpd(M) 
uuclco(M) 
uusched(H) 
. tr(C) 
_ ftw(S) 

tsearch(S) 
_ trlg(S) 
_ trig(S) 



trigonometric functions trlg(S) 

trlg(S) atan(S) atan2(S) trigonometric trlg(S) 

trlg(S) sln(S) cos(S) tan(S) asln(S) trlg(S) 

true(C) return with a zero exit value true(C) 

tsearch(S) tflnd(S) tdelete(S) twalk(S) tsearch(S) 



tBet(C) set terminal modes 

tsort(C) sort a file topologically 

tty port for a modem 

tty special files 



tty(C) get the current port name 

ttyname(S) Isatty(S) find name of a _ 
ttyslot(S) find the slot In the utmp 
tty8(M) login terminals file 



tset(C) 

tsort(C) 

setmodem(C) 

makettys(H) 

tty(C) 

ttyname(S) 

ttyslot(S) 

ttys(M) 
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tsearch(S) ttlnd(S) tdeleta(S) 
dtype(C) determine disk 
flle(C) determine tile 
sysfsCS) get file syetem 
uugetty(M) set terminal 
types(F) primitive system data 

date and time to string ctlme(S) 



getpw(S) get name fr 



systems mountall(C) 
mount (C) 
information 

unget(CP) 
file 
stream 

mktemp(S) make a 
constants 

unlts(C) convert 

uname(C) print the current 
cu(C) call another 
glossary(C) define comnon 
uulog(C) uuname(C) copy files from 
uuname(C) copy files from UNIX to 
uux(C) execute command on remote 
uuto(C) uupick(C) public 
llnk(M) unlink(M) link and 
directories llnk(M) 

pack(C) pcat(C) 
pause(S) suspend process 
a file touch(C) 
programs make(C) maintain, 
Isearch(S) Ifind(S) linear search and 
sync(S) 
sync(C) 
upgrade. hd(C) 
disk 
shutype(N) 
shuttyp«(S) get and sat 
lint (CP) check C language 
du(C) summarize disk 
su(C) make the 
ua(C) 
id(C) print 
setuld(S) set 
crontab(C) manage 
get character login name of the 
environ (N) 

whoami(C) print effective current 



twalk(S) manage binary search trees 

typ« 

type 

type information 

type, modes, speed, line discipline 

types 

types(F) primitive system data types 
tzset(S) asctime(S) cftime(S) convert 

ua(C) user administration program 

uadmin(S) administrative control 

OID 

ulimit(S) get and set user limits 



umaak(C) set file-creation mode mask 

umask(S) set and get file creation mask 
umountalKC) mount/unmount multiple file 
umount(C) mount/unmount a file structure 
uname(C) print the current UNIX 



uname(S) get name of current UNIX system 

undo a previous get of an SCCS file 

unget(CP) undo a previous get of an SCCS 
ungetc(S) push character back into input 
uniq(C) report repeated lines in a file 
unique file name 



unistd(F) file header for symbolic 

units 

units(C) convert units 

UNIX information 

UNIX system 



UNIX terms and symbols 

UNIX to UNIX uucp(C) 

UNIX uucp(C) uulog(C) 
UNIX 



UNIX-to-UNIX system file copy 

unlink files and directories 

unlink (M) link and unlink files and 
unllnk(S) remove directory entry 



unpack (C) compress and expand files 
until signal 



update access and modification times of 

update, and regenerate groups of 

update 

update super block 

update the super-block 



upgrade an additional hard disk 

upgrade. hd(C) upgrade an additional hard 

UPS shutdown configuration utility 

UPS shutdown limits 

usage and syntax 

usage ^_ 

user a super-user or another user 

user administration program 

user and group ID and names 

user and group IDs 

user crontab files 

user cuaerid(S) 

user environment 

user id 



tsearch(S) 

dtype(C) 

file(C) 

sya(s(S) 

uugetty (M) 

types (F) 

types (F) 

ctime(S) 

ua(C) 

uadmln(S) 

getpwCS) 

ulimlt(S) 

umask(C) 

umask ( S ) 

mountall (C) 

mount (C) 

uname(C) 

uname ( S ) 

unget (CP) 

unget (CP) 

ungetc(S) 

unlq(C) 

mktemp(S) 

unlstd(F) 

unita(C) 

units(C) 

uname(C) 

cu(C) 

glossary (C) 

uucp(C) 

uucp(C) 

uux(C) 

uuto(C) 

llnk(H) 

link(M) 

unllnk(S) 

pack(C) 

pause(S) 

touch (C) 

make(C) 
Isearch(S) 

sync(S) 
sync(C) 
upgrade. hd(C) 
upgrade . hd(C) 
9hutype(M) 
shuttype(S) 
lint(CP) 
. du(C) 
. au(C) 
. ua(C) 
. ld(C) 
setuid(S) 
crontab(C) 
cuserid(S) 
environ (M) 
whoaml(C) 



PI-51 



Permuted Index 



newgrp(C) log 
ulimit(S) get and set 
last(C) print last record of 
logname(S) return login name of 
getuid(S) getegid(S) get real/effective 
getuid(S) geteuid(S) get real/effective 
getuid(S) getgid(S) get real/effective 
make the user a super-user or another 
the slot in the utmp tile of the current 
write(C) write to another 
get and set maximum number of 
finger(C) find information about 
walKC) write to all 
fuser(M) identify proceavea 
egrep(C) search file for pattern 

cpset(C) install 
drive tapeutil(C) 
setmode<C) printer modes 
shutype{M) UPS shutdown configuration 
modification times 
utmp(M) wtmp(M) format of 
utmpname(S) endutent(S) access 
getut(S) setutent(S) getutline(S) access 
ttyslot(S) find the slot in the 
entries 

entry getut(S) getutent(S) 
and permissions file 
uucp system 
cleanup 
uucheck(M) check the 
uusched(N) scheduler tor the 
mail from 
uucleanup(M) 
uustat(C) 

uucico(M) file transport program for 
from UNIX to UNIX 
speed, line discipline 
to UNIX uucp(C) 
uucp(C) uulog(C) 
file copy uuto(C) 
transport program 
control 
system file copy 
debugging on 



val(CP) 

abs(S) return integer absolute 
false(C) return with a nonzero exit 
getenv(S) return 
fabs(S) floor, ceiling, and absolute 
fmod(S) floor, ceiling, and absolute 
putenv(S) change or add 
true(C) return with a zero exit 
values (F) machine-dependent 



user into a new group 

user limits 

user logins 

user 

user or group IDs 

user or group IDs 

user or group IDs 

user su(C) 

user ttyslot(S) find 



newgrp(C) 
ulimit IS) 
last(C) 
logname ( S ) 
getuid(S) 
getuid(S) 
getuid(S) 
su(C) 

ttyalot (S) 
write(C) 



ers allowed to log 



using a file or file struct 
using full regular expressi 



earning tape 



ustat(S) get file system statisti 

utilities 

utility progr 

utility 

utility 

utime(S) 



et file access _ 

utmp and wtmp entries 

utmp file entry getut(S) getut 
utmp file entry 




tlt(S) 



utmp(M) 
getut (S) 
getut (S) 
ttyslot(S) 
utmp(M) 
getut(S) 
uucheck(M) 
uucico(M) 
uucleanup (M ) 

uucp directories and permissions file uucheck(M) 



utmp file of the current user 

utmp(M) wtmp(M) format of utmp and wtmp _ 
utmpname(S} endutent(S) access utmp file 

uucheck(M) check the uucp directories 

uucico(M) file transport program for 

uucleanup(ri) uucp spool directory 



uucp file transport program 
uucp link rmail(C) receives _ 
uucp spool directory cleanup 
uucp status inquiry and job c 
uucp system 



uusched(M) 
rmail (C) 
uucleanup(M] 
uuatat(C) 
uucico(M) 
uucp(C) 
uugetty(M) 
uucp(C) 
uucp(C) 
uuto(C) 
uusched(M) 
uustat(C) 



uucp(C) uulog(C) uuname(C) copy files 

uugetty(M) set terminal type, modes. 

uulog(C) uuname(C) copy files from UNIX _ 

uuname(C) copy files from UNIX to UNIX 

uupick(C) public UNIX-to-UNlX system 

uusched(N) scheduler for the uucp file 

uuBtat(C) uucp status inquiry and job 

uuto(C) uuplck(C) public UNIX-to-UNIX uuto(C) 

uutry(M) contact remote system with 

uux(C) execute command on remote UNIX 
uuxqt(M) execute remote command requests 

val(CP) validate an SCCS file 

validate an SCCS file 

value 

value 



value for environment name 

value functions floor(S) ceil(S) 

value functions floor (S) 

value to environment 

value 

values 



uutry (M) 
uux ( C ) 
uuxqt (M) 
val(CP) 
val(CP) 
abs(S) 
false(C) 
getenv(S) 
floor (S) 
floor (S) 
putenv(S) 
true(C) 
values (F) 
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vsprintf(S) print formatted output of 
list 

varargs(F) handles 

get option letter from argument 
assert (S) 
vc(CP) 
get (CP) get a 
sccsdiff(CP) compare two 
output o£ varargs list vprintf(S) 
editor 
more(C) 

with label checking 
filesystem(M) format of a system 
formatted output of varargs list 
varargs list vprint£(S) vfprintf(S) 
virtual terminal management 
waitsem(S) nbwaitsem(S) 
wait(C) 
terminate wait(S) 
processes 
or terminate 
access to semaphore resource 
ftw(S) 



manual for program 



users 

fold(C) fold long lines for finite 
prof(F) profile 
fgetc(S) getchar(S) get character or 
putw(S) fputc(S) put character or 
wc(C) count lines. 
cd(C) change 
chdir ( S ) change 
getcwd(S) get path name of current 
pwd(C) print 
ifrite(S) 
putpwent ( S ) 
wall(C) 
write (C) 



open(S) open for reading or 
drive(C) drive information 
utmp(H) wtmp(M) fomat of utmp and 
utmp(M) 



valuea(F) machine-dependent values 

varargs list vprintf(S) vfprintt(S) 
varargs (F) handles variable argument 

variable argument list 

vc(CP) version control 

vector getopt(S) 



verify program assertion 
version control 



version of an SCCS file 

versions of an SCCS file 

vfprintf(S) vsprintf(S) print formatted 
vi(C) invoke a screen-oriented display 

view a file one full screen at a time 

virtual terminal management 



values(F) 

vprintf (S) 
varargs (F) 
varargs (F) 
vc(CP) 
getopt ( S ) 
assert (S) 
vc(CP) 
get (CP) 
sccsdif f (CP) 
vprintf (S) 
vi(C) 
more(C) 
vt(M) 

volcopy (M) 
filesyst 



wait and check access to semaphore 

wait completion of background processes 
wait for child process to stop or 



volcopy (M) labelit(M) copy file system 

volume tilesystem(M) 

vprintf(S) vfprintf(S) vsprintf{S) print vprintf(S) 

vsprintf (S) print fonnatted output of vprintf (S) 

vt(M) vt(M) 

wait8em(S) 
wait(C) 
wait(S) 

wait(C) wait completion of background wait(C) 

wait(S) wait for child process to stop wait(S) 

waitsem(S) nbwaitsem(S) wait and check waitsem(S) 

walk a file tree ftw(S) 

wall(C) write to all users wall(C) 

wc(C) count lines, words, and characters wc(C) 

what(C) identify files what(C) 

whereis(C) 
whoami(C) 



whereis(C) locate source, binary, or 

whoami(C) print effective current user 

who(C) display who is on the system 

whodo(M) determine who is doing what 

whom(C) display in columns logged in 

width output device 

within a function 



_ who{C) 
_ whodo(H) 
_ whom(C) 
_ fold(C) 
_ prof(F) 
_ getc(S) 
_ putc(S) 
_ wc(C) 
_ cd(C) 
_ chdir (S) 
_ getcwd(S) 
_ pwd(C) 
_ write{S) 
_ putpwent (S) 
_ wall(C) 
_ write(C) 
_ write(C) 
_ write(S) 
_ open(S) 
_ drive (C) 
_ utmp(M) 

wtmp(M) format of utmp and wtmp entries _ utmp(M) 
xar(CP) maintain archives and libraries _ xar(CP) 

xar(F) archive file fomat xar(F) 

xargs(C) construct and execute comnands _ xargs(C) 
xcc(CP) invoke the XENIX compiler xcc(CP) 



word from a stream getc(S) getH(S) 
word on a stream putc(S) putchar(S) 

words, and characters 

trorking directory 

working directory 

working directory 

working directory name 

write on a file 

write password file entry 

write to all users 

write to another user 

write(C) write to another user 

write(S) write on a file 

writing 

written during manufacturing 

wtmp entries 
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enroll (C) x3end(C) 
from flies 
adb ( C ) Invoke 

enroll (C) 

bessel(S) jO(S) 

true(C) return with a 
tlmezone(M) set default system time 



xget(C) secret mail enroll (C) 

xld(CP) invoke the link editor xld(CP) 

xllst(S) fxllst(S) get name list entries xllst(S) 

xnm(CP) print name list xnm(CF) 

x.out general purpose debugger adb(C) 

xpd(M) transparent printer daemon xpd(M) 

xref(CP) cross-reference C programs xref(CP) 

xsend(C) xget(C) secret mail enroll (C) 

xstr(CP) extract strings from C programs xstr(CF) 

xtty(C) set the options for a port xtty(C) 

yO(S) Besael functions bessel(S) 

yacc(CP) invoke a compiler-compiler yacc(CP) 

yes(C) print a string repeatedly yes(C) 

zero exit value true(C) 

zone tlmezone(M) 
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USING THIS MANUAL 



This reference alphabetically describes the commands and 
programs that are on the Altos System V™ Run-time System. 
Altos System V is based on UNIX® System V Release 3 with 
enhancements from Altos and Microsoft. 



ORGANIZATION 



This manual contains the miscellaneous utilities and files 
(M) of the Run-time system. 

For commands, programs, and utilities (C), see the Refer- 
ence (C). 



NOTE 

The last section of the manual, "Change 
Information," sunmiarizes the changes that have 
been made to the manual since the previous 
version. 



MANUAL CONVENTIONS 



The documentation conventions used in this manual are ex- 
plained on the following page. 
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Symbol 



Description 



boldface type What you type. For example: 

Type tartv 

boldface type Used for command or parameter names 

that must be t5rped as shown. 

mail user 

italic type Variables (a value that can change), 

such as user. See the previous exam- 
ple. Also for manual titles, such as 
Reference (C) and Reference (M). 

■wnHiB Keys you press simultaneously (sepa- 

ated by a hyphen and shown in re- 
verse type). For example: 



[ ] 



Ctrl-d 



means you press and 
hold the key and then 

press the d key. 

Keys you press sequentially. 

Optional items in a ssmtax statement. 
If you do not use the optional item, 
the program selects a default action 
to carry out. 

Use only one of the separated items. 

Repeat preceding argument one or 
more times. 

Repeat the preceding argument one or 
more times and separate arguments 
with a comma. 

Terms defined in the text. Quotation 
marks also indicate text from a 
source code example. 
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ADDITIONAL REFERENCE MATERIALS 



For more information on your operating system, see the 
I following list of manuals. To order a manual, call (408) 

434-6688, ext. 3004 and give the manual title and part 
number. 



Owner's Guide (part number 690-21264-nnn or 690-20351- 
nnn) describes how to connect computer components and 
peripherals, turn on power, and use the diagnostic 
programs. 

Using the AOM Menu System (part number 690-18055-nnn) 
describes how to use the Altos Office Manager (AOM) to 
install software and manage the operating system. 

Altos System V User's Guide (part number 690-21 178-nnn) 
(not shipped with the Run-time system) explains basic op- 
erating system concepts and programs (e.g., vi, ed, sh, 
csh, mail, sed, and awk). 

Altos System V Series 386 Operations Guide (part number 
690-21171-nnn) tells how to set up the system for users 
and peripherals, maintain and back up the system, optimize 
system performance, and use uucp communications programs. 
This manual also contains system and LP spooler error mes- 
sages. 

Altos System V Series 386 Reference (C) (part number 
690-22869-nnn) describes the Altos Run- time system 
commands, programs, and utilities. 



Altos System V Series 386 Development System Set (part 
number 690-21585-000) contains reference and tutorial 
material. 



Manuals in this set include: 

Altos System V Series 

User's Guide 
Altos System V Series 

Reference 
Altos System V Series 
Altos System V Series 

Guide and Reference 
Altos System V Series 



386 C Compiler Library and 

386 C Compiler Language 

386 Programmer's Guide 
386 Macro Assembler User's 

386 Reference (CP, S, F) 
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DOCUMENTER'S WORKBENCH (part numbers 690-1 5843-nnn 
and 690-15844-nnn) describes mm, nroff, troff, and type- 
setting functions and commands. 



vi 



Contents 
Miscellaneous (M) 



intro Introduction to miscellaneous features and 
files. 

acct Format of per-process accounting file, 

aliases Alias file for mail, 

aliashash Rebuild data base for mail alias file, 

ascii Map of the ASCII character set. 

boot Secondary bootstrap program, 

brc System initialization procedure. 

captoinfo Converts a termcap description into a terminfo 
description. 

checklist Lists file systems processed by fsck. 

ckbupscd Checks file system backup schedule. 

clock Provides access to the time-of-day chip. 

clone Opens any minor device on a STREAMS driver. 

clri Clears inode. 

crash Examines system images. 

default Default program information directory. 

df Reports number of free disk blocks and inodes. 

dir Format of a directory. 

display Series 500 system console display. 

environ The user environment, 

errprint Displays error log contents. 

ff Fast find, 

filesystem Format of a system volume, 

fine Fast incremental backup, 

free Recovers files from a back-up tape, 

fsdb File system debugger, 

fsinfo Reports information about a file system, 

fsstat Reports file system status, 

fstab File system table, 

fstyp Determines the file system identifier, 

fuser Identifies processes using a file or file 
structure. 
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Contents(M) 



getty Sets terminal mode. 

gettydefs Speed and terminal settings used by getty. 

group Format of the group file. 

infocmp Compares or prints terminfo descriptions, 

inir Cleans the file system and executes init. 

init Process control initialization, 

inittab Script for the init processes, 

inode Format of an inode. 

install Installs commands. 

keyboard Series 500 system console keyboard. 

layout Manages hard disk partitions. 

Idunix Configurable kernel linker, 

link, unlink Links and unlinks files and directories, 

log Interface to STREAMS error logging and event 
tracing. 

Ipadmin Configures the LP spooling system. 

Ipd Line printer daemon. 

Ipinit Adds new line printers to the system. 

Ipon, Ipoff Turns on/off Ip printer schedulers. 

Ipsched, Ipshut, Starts/stops the LP request scheduler and 

Ipmove moves requests. 

makedevs Creates special device files, 

makekey Generates an encryption key. 

makettys Creates tty special files, 

master Master configuration database, 

mem, kmem Memory image file. 

menus Format of a Business Shell menu system, 

mkboot Converts an object file to a bootable object 
file. 

mkfs Constructs a file system. 

mkunix Makes a bootable system file with kernel and 

driver S5niibol tables, 

mnttab Mounted file system table. 

ncheck Generates path names from inode numbers, 

null The null file. 

options Floppy disk installation menu. 

passwd The password file, 

printers Print spooler configuration file, 

profile Sets up an environment at login time, 

pwck, grpck Checks password/group file. 
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rcO Commands to stop the operating system. 

rc2 Commands for multi-user environment. 

sadcon, sadcoff Turns on/off system activity data collector, 

sar System activity report package, 

shutdown Brings a system to single-user or shutdown, 

shutype UPS shutdown configuration utility, 

strace Prints STREAMS trace messages, 

strclean STREAMS error logger cleanup program, 

strerr STREAMS error logger daemon, 

sulogin Special login program invoked by init. 

sysdef Outputs system definition. 

term Conventional names for terminals, 

termcap Terminal capability database, 

terminals List of supported terminals, 

terminfo Terminal capability database, 

termio General terminal interface, 

timezone Sets default system time zone, 

ttys Login terminals file. 

utmp, wtmp Formats of utmp and wtmp entries, 

uucheck Checks the uucp directories and permissions 
file. 

uucico File transport program for the uucp system, 

uucleanup Uucp spool directory cleanup, 

uugetty Sets terminal type, modes, speed, and line 
discipline. 

uusched Scheduler for the uucp file transport program, 

uutry Tries to contact remote system with debugging 
on. 

uuxqt Executes remote command requests. 

volcopy, labelit Copies file system with label checking, 

vt Virtual terminal management. 

whodo Determines who is doing what. 

xpd Transparent printer daemon. 
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Name 

intro - Introduction to miscellaneous features and files. 
Description 

This section contains miscellaneous information for main- 
taining the entire system, including descriptions of 
files, devices, tables, and programs. 
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Name 

acct - Format of per-process accounting file. 



Description 

Files produced as a result of calling acct(S) have records 
in the form defined by <sys/acct.h>. 

In acj'lagf the AFORK flag is turned on by each fork(S) 
and turned off by an exec(S). The ac comm field is in- 
herited from the parent process and is reset by any exec. 
Each time the system charges the process with a clock 
tick, it also adds the current process size to ac mem com- 
puted as follows: 

(data size) + (text size) / (number of in-core 
processes using text) 

The value of ac mem/ac stime can be viewed as an ap- 
proximation to the mean process size, as modified by 
text-sharing. 



See Also 

acct(C), acct(S) 



Notes 

The ac mem value for a short-lived command gives little 
information about the actual size of the command, because 
ac mem may be incremented while a different command 
(e.g., the shell) is being executed by the process. 
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Name 

aliases - Alias file for mail. 



Syntax 

/usr/lib/mail/allases 



Description 

This file describes user ID aliases that are used by the 
/usr/lib/sendmail command. It is fomatted as a series of 
lines of the form: 

name: naTne_U name_2, ... name n 

Name is the name to alias, and name n are the aliases for 
that name. For example, 

terry: pubslterry 

Lines beginning with white space are continuation lines. 
Lines beginning with # are comments. 

Aliasing occurs only on local names. Loops cannot occur, 
since no message will be sent to any person more than 
once. 

Aliases is only the raw data file; the actual aliasing 
information is placed in binary format in the file 
/usr/lib/mail/aliases.hash by executing the program 
aliashash(M). Each time you change the aliases file, run 
aliashash for the changes to take effect. 



See Also 

aliashash(M), mail(C) 
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Name 

aliashash - Rebuild the data base for the mail alias file. 

Syntax 

aliashash 

Description 

Aliashash rebuilds the random access data base for the 
mail alias file /usr/lib/mail/aliases. For the change to 
take effect, run aliashash each time /usr/lib/mail/aliases 
is changed. 

See Also 

aliases(M) 
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Name 

ascii - Map of the ASCII character set. 



Description 

Ascii is a map of the ASCII character set. It lists both 
octal and hexadecimal equivalents of each character. It 
contains: 



000 


nul 


001 


soh 


002 


stx 


003 


etx 


004 


eot 


005 


enq 


006 


ack 


007 


bel 


010 


bs 


Oil 


ht 


012 


nl 


013 


vt 


014 


np 


015 


cr 


016 


so 


017 


si 


020 


die 


021 


del 


022 


dc2 


023 


dc3 


024 


dc4 


025 


nak 


026 


syn 


027 


etb 


030 


can 


031 


em 


032 


sub 


033 


esc 


034 


fs 


035 


gs 


036 


rs 


037 


us 


040 


sp 


041 


! 


042 


" 


043 


# 


044 


$ 


045 


% 


046 


& 


047 


' 


050 


( 


051 


) 


052 


* 


053 


+ 


054 




055 


- 


056 




057 


/ 


060 


0 


061 


1 


062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


067 


7 


070 


8 


071 


9 


072 




073 




074 


< 


075 


= 


076 


> 


077 




100 


@ 


101 


A 


102 


B 


103 


C 


104 


D 


105 


E 


106 


F 


107 


G 


110 


H 


111 


I 


112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


117 


0 


120 


P 


121 


Q 


122 


R 


123 


S 


124 


T 


125 


U 


126 


V 


127 


W 


130 


X 


131 


Y 


132 


Z 


133 


[ 


134 


\ 


135 


] 


136 




137 


_ 


140 




141 


a 


142 


b 


143 


c 


144 


d 


145 


e 


146 


f 


147 


g 


150 


h 


151 


i 


152 


j 


153 


k 


154 


1 


155 


m 


156 


n 


157 


o 


160 


P 


161 


q 


162 


r 


163 


s 


164 


t 


165 


u 


166 


V 


167 


w 


170 


X 


171 


y 


172 


z 


173 


{ 


174 


1 


175 


} 


176 




177 


de. 


00 


nul 


01 


soh 


02 


stx 


03 


etx 


04 


eot 


05 


enq 


06 


ack 


07 


bel 


08 


bs 


09 


ht 


Oa 


nl 


Ob 


vt 


Oc 


np 


Od 


cr 


Oe 


so 


Of 


si 


10 


die 


11 


del 


12 


dc2 


13 


dc3 


14 


dc4 


15 


nak 


16 


syn 


17 


etb 


18 


can 


19 


em 


la 


sub 


lb 


esc 


Ic 


fs 


Id 


gs 


le 


rs 


If 


us 


20 


sp 


21 


! 


22 




23 


# 


24 


$ 


25 




26 


& 


27 




28 


( 


29 


) 


2a 


* 


2b 


+ 


2c 




2d 




2e 




2f 


/ 


30 


0 


31 


1 


32 


2 


33 


3 


34 


4 


35 


5 


36 


6 


37 


7 


38 


8 


39 


9 


3a 




3b 




3c 


< 


3d 




3e 


> 


3f 


■7 


40 


@ 


41 


A 


42 


B 


43 


C 


44 


D 


45 


E 


46 


F 


47 


G 


48 


H 


49 


I 


4a 


J 


4b 


K 


4c 


L 


4d 


M 


4e 


N 


4f 


0 


50 


P 


51 


Q 


52 


R 


53 


S 


54 


T 


55 


U 


56 


V 


57 


W 


58 


X 


59 


Y 


5a 


Z 


5b 


[ 


5c 


\ 


5d 


] 


5e 




5f 




60 




61 


a 


62 


b 


63 


c 


64 


d 


65 


e 


66 


f 


67 


g 


68 


h 


69 


i 


6a 


j 


6b 


k 


6c 


1 


6d 


m 


6e 


n 


6f 


o 


70 


P 


71 


q 


72 


r 


73 


s 


74 


t 


75 


u 


76 


V 


77 


w 


78 


X 


79 


y 


7a 


z 


7b 


{ 


7c 


1 


7d 


> 


7e 




7f 


del 
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Name 

boot - Secondary bootstrap program. 



Syntax 

/boot 



Description 

The boot program brings up the operating system from a 
cold start. In addition to bringing an operating system 
file into memory from disk, boot also initializes all I/O 
subsystems and loads them with their operating software. 
The boot program keeps track of which I/O boards are 
present in a particular configuration and passes this 
information to the operating system. 

The boot program is interactive and will prompt for the 
name of an operating system file you want to use. This 
permits the selection of one of several kernel files. 
Additionally, if the CPU Monitor sets the appropriate 
flag, boot will attempt to automatically boot the kernel 
file. If it cannot find this file, boot will go into in- 
teractive mode, and will display: 



386 System Boot 

Cannot open hdt0,2)\inix 

Enter bootable program or ? for help 
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For example, if you type ? ItfJiiW . you will see the follow- 
ing display: 



Boot n.n.nnn of Jan 7, 1^87 

Typ4 th<^ tVii-X namtt at the program you wish KO boot . 
The default; boot program hd(^,2)uniK. 
Press 1E;$C to start with default name^ 

Press § to era^e line, or backspace* to erase a character. 
Press the DEL key to abort the boot once it has started. 

Unix's on hd(Q,2) are: 

hd(0,2)unix 

hd (0,2) Unix. net 

Enter bootable program or '?' for Kelp. 



Enter the bootable program in the form: 

root_device(disk,partition)kernel_file 

where root device is: 

fd - floppy disk 
hd - main hard disk 

The disk field selects a disk number which contains a file 
system in which to find I/O subsystem download code and 
kernel files. On the floppy, this is always 0. On the 
hard disk, the disk is usually the root file system, 0 for 
the root disk. The partition field specifies which parti- 
tion contains the root file system, and is always 0 for 
the floppy, and normally 2 for hard disk. 

The kernel Jile field is the path name of a kernel file 
(relative to /). 

T5^ical invocations are: 

fd(0,0)unix.fd 
hd(0,2)unix 
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The boot program searches the file system in which it 
found the kernel for code files to load into the I/O sub- 
system boards. Those files are always kept in the /etc 
directory and are named: 



/etc/dlcode/ioc 



/etc/dlcode/fp. type 



/etc/dlcode/sio 



/etc/dlcode /sio [0123] 



/etc/dlcode/mdc 



/etc/dlcode/mdc [0123] 



generic IOC code (Series 1000 
only) 

file processor specific 
(Series 2000 only) 

generic SIO code (Series 
2000 only) 

board-specific SIO code 
(Series 2000 only) 

generic MDC code (Series 
2000 only) 

board-specific MDC code 
(Series 2000 only) 



If boot can find a file that corresponds to a particular 
SIO or MDC board, it will load that file; otherwise, it 
loads the generic code file. 



Files 



/boot 
/unix* 

/etc/dlcode/fp. esdi 

/etc/ldlcode/fp 

/etc/dlcode/sio 
/etc/dlcode/sio? 
/etc/dlcode/mdc 
/etc/dlcode/mdc? 



Secondary boot 

Operating system kernel file 

File processor download code 

for ESDI drive 
File processor download code 

for ST506 drive 
SIO generic code 
SIO specific code 
SIO generic code 
SIO specific code 



See Also 

layout(M) 
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Diagnostics 

For an error, boot displays an error message, then returns 
to its prompt. Tiie following is a list of the most common 
messages. 

bad drive specifier x 

An invalid drive number was given, only 0-2 are 
valid. 

bad superblock: s_magic x 

The partition given doesn't appear to have a 
filesystem on it. 

device error, status [0123] 

An error occurred while trying to read the program. 
The boot system retries up to 10 times on each error. 
If all 10 attempts fail, the following message ap- 
pears: "Fatal disk error (10) retries." 

pathname not found 

The supplied pathname does not correspond to an 
existing file. 



Notes 

Boot cannot be used to load programs that have not been 
linked for stand-alone execution. 
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Name 

brc - System initialization procedures. 



Syntax 

/etc/brc 



Description 

These shell procedures are executed via entries in 
/etc/inittab by init(M) whenever the system is booted (or 
rebooted). 

The brc procedure clears the mounted file system table, 
/etc/mnttab, and puts the entry for the root file system 
into the mount table. 

After these two procedures have executed, init checks for 
the initdefault value in /etc/inittab. This tells init in 
which run level to place the system. Since initdefault is 
initially set to 2, the system will be placed in the 
multi-user state via the /etc/rc2 procedure. 



See Also 

fsck(C), init(M), rc2(M), shutdown(C) 
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Name 

captoinfo - Converts a termcap description into a terminfo 
description. 



Syntax 

captoinfo [-v...] [-V] [-1] [-w width] file ... 



Description 

Captoinfo looks in file for termcap(M) descriptions. For 
each one found, an equivalent terminfo(M) description is 
written to standard output, along with any comments found. 
A description that is expressed as relative to another 
description (as specified in the termcap tc= field) will 
be reduced to the minimum superset before being output. 

If no file is given, then the environment variable 
TERMCAP is used for the filename or entry. If 
TERMCAP is a full pathname to a file, only the terminal 
whose name is specified in the environment variable 
TERM is extracted from that file. If the environment var- 
iable TERMCAP is not set, then the file /etc/termcap 
is read. 



Options 

-V Print tracing information on standard error as the 
program runs. Specifying additional -v options will 
cause more detailed information to be printed. 

-V Print the version of the program in use on standard 
error and exit. 

-1 Cause the fields to print one to a line. Otherwise, 
the fields will be printed several to a line to a 
maximum width of 60 characters. 

-w Change the output to width characters. 
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Files 

/usr/lib/terminfo/?/* Compiled terminal description 

database 



Caveats 

Certain termcap defaults are assumed to be true. For ex- 
ample, the bell character (terminfo bel) is assumed to be 
"G. The linefeed capability (termcap nl) is assumed to be 
the same for both cursor down and scroll forward (terminfo 
cudl and ind, respectively). Padding information is as- 
sumed to belong at the end of the string. 

The algorithm used to expand parameterized information 
for termcap fields such as cursor position (termcap cm, 
terminfo cup) will sometimes produce a string which, 
though technically correct, may not be optimal. In par- 
ticular, the rarely used termcap operation %n will produce 
strings that are especially long. Most occurrences of 
these non-optimal strings will be flagged with a warning 
message and may need to be recoded by hand. 

The short two-letter name at the beginning of the list of 
names in a termcap entry, a hold-over from an earlier ver- 
sion of the UNIX system, has been removed. 



Diagnostics 

tgetent failed with return code n {reason). 

The termcap entry is not valid. In particular, check 
for an invalid 'tc=' entry. 

unknown type given for the termcap code cc. 

The termcap description had an entry for cc whose 
type was not boolean, numeric, or string. 

wrong type given for the boolean (numeric, string) termcap 
code cc. The boolean termcap entry cc was entered 
as a numeric or string capability. 

the boolean (numeric, string) termcap code cc is not a 

valid name. An unknown termcap code was specified. 
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tgetent failed on TERM=fcrm. 

The terminal type specified could not be found in the 
termcap file. 

TERM=term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The 
correct way to cancel an entry is with an '@', as in 
':bs@:'. Giving a null string could cause incorrect 
assumptions to be made by the software which uses 
termcap or terminfo. 

a function key for cc was specified, but it already has 

the value vv. 

When parsing the ko capability, the key cc was 
specified as having the same value as the capability 
cc, but the key cc already had a value assigned to 
it. 

the unknown termcap name cc was specified in the ko 
termcap capability. 

A key was specified in the ko capability which could 

not be handled. 

the vi character v (info ii) has the value xx, but ma 
gives n. 

The ma capability specified a function key with a 
value different from that specified in another set- 
ting of the same key. 

the unknown vi key v was specified in the ma termcap 
capability. 

A vi(C) key unknown to captoinfo was specified in the 
ma capability. 

Warning: termcap sg (nn) and termcap ug (nn) had different 
values. 

terminfo assumes that the sg (now xmc) and ug values 
were the same. 

Warning: the string produced for ii may be inefficient. 
The parameterized string being created should be 
rewritten by hand. 

Null termname given. 

The terminal type was null. This is given if the 
environment variable TERM is not set or is null. 
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cannot open file for reading. 

The specified file could not be opened. 



See Also 

tic(C), terminfo(M) and curses(S), in the Reference 
(CP, S, F) 



Notes 

Captoinfo should be used to convert termcap entries to 
terminfo(M) entries because the termcap database (from 
earlier versions of UNIX System V) may not be supplied 
in future releases. 
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Name 

checklist - Lists file systems processed by fsck. 



Description 

The /etc/checklist file contains a list of the file sys- 
tems to be checked when fsck(C) is invoked without argu- 
ments. The list contains at most 15 special file names. 
Each special file name must be on a separate line and must 
correspond to a file system. 



See Also 

fsck(C) 
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Name 

ckbupscd - Checks file system backup schedule. 



Syntax 

/etc/ckbupsed [ -m ] 



Description 

Ckbupscd consults the file /etc/bupsched and prints the 
file system lists from lines with date and time specifica- 
tions matching the current time. If the -m flag is pre- 
sent an introductory message in the output is suppressed 
so that only the file system lists are printed. Entries 
in the /etc/bupsched file are printed under the control of 
cron(C). 

The file /etc/bupsched should contain lines of 4 or more 
fields, separated by spaces or tabs. The first 3 fields 
(the schedule fields) specify a range of dates and times. 
The rest of the fields constitute a list of names of file 
systems to be printed if ckbupscd is run at some time 
within the range given by the schedule fields. The gen- 
eral format is: 

timeUtime] dayUday] monthiymonth] fsyslist 

where: 

time Specifies an hour of the day (0 through 23), 

matching any time within that hour, or an exact 
time of day {0:00 through 23:59). 

day Specifies a day of the week (sun through sat) or 

day of the month (I through 31). 

month Specifies the month in which the time and day 
fields are valid. Legal values are the month 
numbers (1 through 12). 

fsyslist The rest of the line is taken to be a file sys- 
tem list to print. 
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Multiple time, day, and month specifications may be sep- 
arated by commas, in which case they are evaluated left to 
right. 

An asterisk (*) always matches the current value for that 
field. 

A line beginning with a sharp sign (#) is interpreted as a 
comment and ignored. 

The longest line allowed (including continuations) is 1024 
characters. 



Examples 

The following are examples of lines which could appear in 
the /etc/bupsched file. 

06:00-09:00 fri 1,2,3,4,5,6,7,8,9,10,11 /appUe 

Prints the file system name /applic if ckbupsed is run 
between 6:00am and 9:00am any Friday during any month ex 
cept December. 

00:00-06:00,16:00-23:59 1,2,3,4,5,6,7 1,8 / 

Prints a reminder to backup the root (/) file system if 
ckbupsed is run between the times of 4:00pm and 6:00am 
during the first week of August or January. 



Files 

/etc/bupsched Specification file containing times 

and file system to back up 



See Also 

cron(C), echo(C), sh(C), sysadm(C) 



Notes 

Ckbupsed will report file systems due for backup if in- 
voked any time in the window. It does not know that bac 
ups may have just been made. 



2 



CLOCK(M) 



CLOCK(M) 



Name 

clock - Provides access to the time-of-day chip. 

staticram - Provides 16 bytes of battery-backed-up memory. 



Description 

The file /dev/clock provides access to the time-of-day 
chip. The current time, date, and year can be read or 
written as ASCII data. (See for example, the -s option of 
date.) The date is stored in the form: 

MMDDhhmmYY 

Where MM is the month, DD is the day of the month, hh is 
the hour, mm is the minute, and YY is the last 2 digits of 
the year. 

The clock is maintained by a battery, even when the power 
is off. The clock is normally used to set the system's 
idea of the date on every power-up. 

The file /dev/staticram provides 16 bytes of 
battery-backed-up memory, which is actually part of the 
time-of-day chip. It may be used for anything the system 
administrator wishes, such as a system ID code, etc. This 
memory remains valid until the battery wears out, or until 
it is rewritten. 



1 



CLONE(M) 



CLONE(M) 



Name 

clone - Opens any minor device on a STREAMS driver. 



Description 

Clone is a STREAMS software driver that finds and opens 
an unused minor device on another STREAMS driver. The 
minor device passed to clone during the open is inter- 
preted as the major device number of another STREAMS 
driver for which an unused minor device is to be obtained. 
Each such open results in a separate stream to a previous- 
ly unused minor device. 

The clone driver consists solely of an open function. 
This open function performs all of the necessary work so 
that subsequent system calls (including close(S)) require 
no further involvement of clone. 



Notes 

Multiple opens of the same minor device cannot be done 
through the clone interface. Executing stat(S) on the 
file system node for a cloned device yields a different 
result from executing fstat(S) using a file descriptor 
obtained from opening the node. 



See Also 

log(M), and the STREAMS Programmer's Guide 
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Name 

clri - Clears an inode. 



Syntax 

/etc/clri special i-number... 



Description 

Clri writes nulls on the 64 bytes at offset i-number from 
the start of the inode list. This effectively eliminates 
the inode at that address. Special is the device name on 
which a file system has been defined. After clri is exe- 
cuted, any blocks in the affected file will show up as 
"not accounted for" when fsck(C) is run against the 
file-system. The inode may be allocated to a new file. 

Read and write permission is required on the specified 
special device. 

This command is used to remove a file which appears in no 
directory; that is, to get rid of a file which cannot be 
removed with the rm(C) command. 



See Also 

fsck(C), fsdb(M), ncheck(M), rm(C), and fs(F) in the 
Reference (CP, S, F) 



Notes 

If the file is open for writing, clri will not work. The 
file system containing the file should NOT be mounted. 

If clri is used on the inode number of a file that does 
appear in a directory, it is imperative to remove the en- 
try in the directory at once, since the inode may be allo- 
cated to a new file. The old directory entry, if not re- 
moved, continues to point to the same file. This sounds 
like a link, but does not work like one. Removing the old 
entry destroys the new file. 
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Name 

crash - Examines system images. 



Syntax 

/etc/crash [ -d dumpfile ] [ -n namelist ] [ -o offset ] 
[ -w output file ] 



Description 

The crash command is used to examine the system memory 
image of a live or a crashed system by formatting and 
printing control structures, tables, and other informa- 
tion. Command line arguments to crash are dumpfiley 
namelistf offset^ and outputfile. 

The dumpfile is the file containing the system memory 
image. The default dumpfile is /dev/kmem. The system 
image can also be /dev/hdO. restart if the system is in a 
panic state. 

The text file namelist contains the sjnnbol table informa- 
tion needed for symbolic access to the system memory imag( 
to be examined. The default namelist is /unix. If a sys- 
tem image from another machine is to be examined, the cor 
responding text file must be copied from that machine. 

The offset option offsets from the beginning of dumpfile 
at which data starts. This is useful with 
/dev/hdO. restart where offset is 1024. 

When the crash command is invoked, a session is initiated. 
The output from a crash session is directed to outputfile. 
The default outputfile is the standard output. 

Input during a crash session is of the form: 

function [argument ...] 

where function is one of the crash functions described in 
the Functions section of this command description, and 
arguments are qualifying data that indicate which items of 
the system image are to be printed. 
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The default for process-related items is the current pro- 
cess for a running system and the process that was running 
at the time of the crash for a crashed system. If the 
contents of a table are being dumped, the default is all 
active table entries. 

The following function options are available to crash 
functions wherever they are semantically valid. 



-e Display every entry in a table. 

-f Display the full structure. 

-p Interpret all address arguments in the com- 

mand line as physical addresses. 

-s process Specify a process slot other than the 

default. 

-w file Redirect the output of a function to file. 



Note that if the -p option is used, all address and symbol 
arguments explicitly entered on the command line will be 
interpreted as physical addresses. If they are not phys- 
ical addresses, results will be inconsistent. 

The functions mode, defproc, and redirect correspond to 
the function options -p, -s, and -w. The mode function 
may be used to set the address translation mode to phys- 
ical or virtual for all subsequently entered functions; 
defproc sets the value of the process slot argument for 
subsequent functions; and redirect redirects all subse- 
quent output. 

Output from crash functions may be piped to another pro- 
gram in the following way: 

function [argument ...]lshell_command 

For example, 

mount ! grep rw 

will write all mount table entries with an rw flag to the 
standard output. The redirection option (-w) cannot be 
used with this feature. 
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Depending on the context of the function, numeric argu- 
ments will be assumed to be in a specific radix. Counts 
are assumed to be decimal. Addresses are always hexa- 
decimal. Table slot arguments are always decimal. Table 
slot arguments larger than the size of the function table 
will not be interpreted correctly. Use the findslot func- 
tion to translate from an address to a table slot number. 
Default bases on all arguments may be overridden. The C 
conventions for designating the bases of numbers are re- 
cognized. A number that is usually interpreted as decimal 
will be interpreted as hexadecimal if it is preceded by Ox 
and as octal if it is preceded by 0. Decimal override is 
designated by Od, and binary by Ob. 

Aliases for functions may be any uniquely identifiable 
initial substring of the function name. Traditional 
aliases of one letter, such as p for proc, remain valid. 

Many functions accept different forms of entry for the 
same argument. Requests for table information will accept 
a table entry number or a range. A range of slot numbers 
may be specified in the form: 

a-b 

where a and b are decimal numbers. An expression consists 
of two operands and an operator. An operand may be an 
address, a symbol, or a number; the operator may be +, -, 
*, /, &, or |. An operand that is a number should be pre- 
ceded by a radix prefix if it is not a decimal number (0 
for octal. Ox for hexadecimal, Ob for binary). The ex- 
pression must be enclosed in parentheses (). Other func- 
tions will accept any of these argument forms that are 
meaningful. 

Two abbreviated arguments to crash functions are used 
throughout. Both accept data entered in several forms. 
They may be expanded into the following: 

table_entry = table entry [range 

start_addr = address | symbol | expression 
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Functions 

?[-w file] 

List available functions. 

Icmd 

Escape to the shell to execute a command. 
< filename 

Take input from filename until end-of-file (EOF). 
Lines starting with a "#" are comments and are 
ignored. 

adv [-e] [-W file] [[-p] table entry...] 
Print the advertise table. 

base [-W file] number ... 

Print number in binary, octal, decimal, and hexa- 
decimal. A number in a radix other than decimal 
should be preceded by a prefix that indicates its 
radix as follows; Ox, hexadecimal; 0, octal; and Ob, 
binary. 

buffer [-W file] [-format] bufferslot 
or 

buffer [-W file] [-format] [-p]start_addr 
Alias: b. 

Print the contents of a buffer in the designated for- 
mat, where format can be: 

-b byte 

-c character 

-d decimal 

-X hexadecimal 

-o octal 

-r directory 

-i inode 

If no format is given, the previous format is used. 
The default format at the beginning of a crash ses- 
sion is hexadecimal. 
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bufhdr [-f] [-W file] [[-p]table_entry ...] 
Alias: buf. 

Print system buffer headers. 

callout [-W file] 
Alias: c. 

Print the callout table. 

dballoc [-W file] [class... ] 

Print the dballoc table. If a class is entered, only 
data block allocation information for that class will 
be printed. 

dbfree [-w file] [class... ] 

Print free streams data block headers. If a class is 
entered, only data block headers for the class speci- 
fied will be printed. 

dblock [-e] [-w file] [class... ] 

or 

dblock [-6] [-W file] [[-p] table entry... ] 

Print allocated streams data block headers. If the 
class option (-c) is used, only data block headers 
for the class specified will be printed. 

defproc [-w file] [-c] 

or 

defproc [-w file] [slot] 

Set the value of the process slot argument. The pro- 
cess slot argument may be set to the current slot 
number (-c) or the slot number may be specified. If 
no argument is entered, the value of the previously 
set slot number is printed. At the start of a crash 
session, the process slot is set to the current pro- 
cess. 

dis [-W file] [-a] start _address[count] 

Disassemble from the start address for count instruc- 
tions. The default count is 1. The absolute option 
(-a) specifies a nonsymbolic disassembly. 
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ds [-W file] virtual address ... 

Print the data symbol whose address is closest to, 
but not greater than, the address entered. 

file [-e] [-W file] [[-v]t able entry ...] 
Alias: f. 

Print the file table. 

findaddr [-w file] table slot 

Print the address of slot in table. Only tables 
available to the size function are available to 
findaddr. 

findslot [-W file] virtual _addr ess ... 

Print the table, entry slot number, and offset for 
the address entered. Only tables available to the 
size function are available to findslot. 

fs [-W file] [[-p] table entry...] 

Print the file system information table. 

gdp [-e] [-f] [-W file ] [[-p] table_entry...] 
Print the gift descriptor protocol table. 

gdt [-e] [-W file] [[-p] table entry...] 
Print the global descriptor table. 

help [-W file] -a function ... 

Print a description of the named function, including 
syntax and aliases. The -a option lists all func- 
tions. 

idt [-e] [-W file] [[-p] table entry ...] 
Print the interrupt descriptor table. 

inode [-e] [-f] [-w file] [[-p]table_entry ...] 
Alias: i. 

Print the inode table, including file system switch 
information. 

kfp [-W file] [value] 

Print the frame pointer for the start of a kernel 
stack trace. If the value argument is entered, the 
kfp is set to that value. 
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Ick [-e] [-W file] [[-p] table entry ... 
Alias: 1. 

Print record- locking information. If the -e option 
is used or table address arguments are given, the 
record lock list is printed. If no argument is en- 
tered, information on locks relative to inodes is 
printed. 

Idt [-e] [-W file] [-s process] [[-p] table entry ...] 

Print the local descriptor table for the given pro- 
cess, or for the current process if none is given. 

linkblk [-e] [-w file] [[-p] table entry ...] 
Print the linkblk table. 

map [-W file] mapname ... 

Print the map structure of the given mapname. 

mbfree [-w file] 

Print free streams message block headers. 

mblock [-e] [-w filename] [[-p]t able entry ...] 

Print allocated streams message block headers. 

mode [-W file] [mode] 

Set address translation of arguments to virtual (v) 
or physical (p) mode. If no mode argument is given, 
the current mode is printed. At the start of a crash 
session, the mode is virtual. 

mount [-8] [-W file] [[-^]table entry ...] 
Alias: m. 

Print the mount table. 



nm [-W file] symbol ... 

Print value and type for the given symbol. 

od [-p] [-W file] [-format] [-mode] [-s process] 
start _addr[count] 
Alias: rd. 

Print count values starting at the start address in 
one of the following formats: character (-c), deci- 
mal (-d), hexadecimal (-x), octal (-o), ascii (-a), 
or hexadecimal/character (-h), and one of the follow- 
ing modes: long (-1), short (-t), or byte (-b). The 
default mode for character and ascii formats is byte; 
the default mode for decimal, hexadecimal, and octal 
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formats is long. The format -h prints both hexa- 
decimal and character representations of the ad- 
dresses dumped; no mode needs to be specified. When 
format or mode is omitted, the previous value is 
used. At the start of a crash session, the format is 
hexadecimal and the mode is long. If no count is 
entered, 1 is assumed. 

pagemode [-1 lines] [-on | -off] 

Toggle pagemode. If on, pause after every lines (24 
by default). Similar to more(C). 

panic 

Print the latest system notices, warnings and panic 
messages from the limited circular buffer kept in 
memory. 

pcb [-W file process] 

Print the process control block (TSS) for the given 
process. If no arguments are given, the active TSS 
for the current process is printed. 

pdt [-e] [-W file] [-s process] section segment 

or 

pdt [-e] [-W file] [-s process] [-p] start_addr[count] 

The page descriptor table starting at the start ad- 
dress for count entries is printed. If no count is 
entered, 1 is assumed. 

pfdat [-e] [-W file] [[-p]tahle_entry ...] 
Print the pfdata table. 

proc [-f] [-W file] [[-p]table_entry ... ifprocid ...] 

or 

proc [-f] [-W file] [-r] 

Print the process table. Process table information 
may be specified in two ways. First, any mixture of 
table entries and process ids may be entered. Each 
process id must be preceded by a #. Alternatively, 
process table information for runnable processes may 
be specified with the runnable option (-r). The full 
option (-f) details most of the information in the 
process table as well as the pregion table for that 
process. 
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qrun [-w file] 

Print the list of scheduled streams queues. 

queue [-e] [-w file] [[-p]table entry... ] 
Print streams queues. 

quit 

Alias: q. 

Terminate the crash session. 

rcvd [-e] [-f] [-w file] [[-p]t able entry... ] 
Print the receive descriptor table. 

redirect [-w file] [-c] 

or 

redirect [-w file] [file] 

Used with a file name, redirect output of a crash 
session to the named file. If no argument is given, 
the file name to which output is being redirected is 
printed. Alternatively, the close option (-c) closes 
the previously set file and redirects output to the 
standard output. 

region [-e] [-f] [-w file] [[-p]t able entry ...] 
Print the region table. 

search [-p] [-w file] [-m mask] [-s process] pattern 
startaddr count 
Print the long words in memory that match pat tern ^ 
beginning at the start address for count long words. 
The mask is anded (&) with each memory word and th( 
result compared against the pattern. The mask de- 
faults to Oxffffffff. 

size [-W file] [-x] [structure name ...] 

Print the size of the designated structure. The -x 
option prints the size in hexadecimal. If no argu- 
ment is given, a list of the structure names for 
which sizes are available is printed. 

sndd [-e] [-w file] [[-p]table_entry... ] 
Print the send descriptor table. 

srmount [-e] [-w file] [[-p]table_entry... ] 
Print the server mount table. 
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stack [-W file] [process] 
Alias: s. 

Dump stack. If no arguments are entered, the kernel 
stack for the current process is printed. Otherwise, 
the kernel stack for the given process is printed. 

stream [-e] [-f] [-w file] [[-p]entry table... ] 
Print the streams table. 

strstat [-W file] 

Print streams statistics. 

trace [-w file] [-r] [process] 
Alias: t. 

Print stack trace. The kfp value is used with the -r 
option. 

ts [-W file] virtual address ... 

Print closest text symbol to the designated address. 

tty [-e] [-f] [-W file] [-ttype[[-v]table_entry ...]] 
Valid types: mdc, sc, kd 

Print the tty table. If no arguments are given, the 
tty table for mdc is printed. If the -t option is 
used, the table for the single tty type specified is 
printed. If no argument follows the type option, all 
entries in the table are printed. A single tty entry 
may be specified from the start address. 

user [-f] [-W file] [process slot] 
Alias: u. 

Print the ublock for the designated process. 

var [-W file] 
Alias: v. 

Print the tunable system parameters. 

vtop [-W file] [-S process] start addr ... 

Print the physical address translation of the virtual 
start address. 
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FUes 

/dev/kmem System image of currently running 

system 

/dev/hdO. restart Used to access the saved system image 
on hard disk. 



See Also 

sh(C), test(C) 
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Name 

default - Default program information directory. 



Description 

The files in the /etc/default directory contain the de- 
fault information used by system commands such as Ipd(M) 
and remote (C). Default information is any information 
required by the command that is not explicitly given when 
the command is invoked. 

The directory may contain zero or more files. Each file 
corresponds to one or more commands. A conmiand searches 
for a file whenever it has been invoked without sufficient 
information. Each file contains zero or more entries 
which define the default information. Each entry has one 
of the following forms: 

keyword or keyword=value 

where keyword identifies the type of information available 
and value defines its value. Both keyword and value con- 
sist of letters, digits, and punctuation. The exact 
spelling of keyword and the appropriate value depends on 
the command and are described with the individual com- 
mands. 

Any line in a file beginning with a number sign (#) is 
considered a comment and is ignored. 



Files 

/etc/default/lpd 
/etc/default/passwd 
/etc/default/quot 
/etc/default/su 



See Also 

Ipr(C), quot(C), su(C) 



1 



DF(M) 



DF(M) 



Name 

df - Reports number of free disk blocks and inodes. 



Syntax 

df [-It] [-f] [file-system \ directory \ mounted-resource] 



Description 

The df command prints out the number of free blocks and 
free inodes in mounted file systems, directories, or 
mounted resources by examining the counts kept in the 
super-blocks. 

File-system may be specified either by device name (e.g., 
/dev/hdlb) or by mount point directory name (e.g., /usr). 

Directory can be a directory name. The report presents 
information for the device that contains the directory. 

Mounted-resource can be a remote resource name. The re- 
port presents information for the remote device that con- 
tains the resource. 

If no arguments are used, the free space on all locally 
and remotely mounted file systems is printed. 

The df conmiand uses the following options: 

-1 Reports on local file systems only. 

-t Causes the figures for total allocated blocks and 

inodes to be reported as well as the free blocks and 
inodes. 

-f An actual count of the blocks in the free list is 
made, rather than taking the figure from the 
super-block (free inodes are not reported). This 
option will not print any information about mounted 
remote resources. 
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Note 

If multiple remote resources are listed that reside on the 
same file system on a remote machine, each listing after 
the first one will be marked with an asterisk. 



Files 



/dev/* 
/etc/mnttab 



See Also 

mount(M) mnttab(M), and fs(F) in the Reference (CP, S, F) 
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Name 

dir - Format of a directory. 



Syntax 

^include <sys/dir.h> 



Description 

A directory behaves exactly like an ordinary file, except 
that no user may write into a directory. The fact that a 
file is a directory is indicated by a bit in the flag word 
of its inode entry (see filesystem(M)). The structure of 
a directory is given in the include file 
/usr/include/sys/dir.h. 

By convention, the first two entries in each directory are 
"dot" (.) and "dot dot" (..). The first is an entry for 
the directory itself. The second is for the parent direc- 
tory. The meaning of "dot dot" is modified for the root 
directory of the master file system; there is no parent, 
so "dot dot" has the same meaning as "dot." 

The first 2 bytes of each entry are the inode numbers, 
which will be zero if the entry has been removed. The 
next 14 bytes are the filename. If the name is exactly 14 
bytes, there will be no terminating null byte. 



See Also 

dir(S), filesystem(M) 
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Name 

display - Series 500 system console display. 

I 

Description 

The system console (and user's terminal) is composed of 
two separate pieces: the keyboard (see keyboard(M)) and 
the display. Because of their complexity and because 
there are two possible display interfaces (the monochrome 
and color /graphics adapters), they are discussed in sepa- 
rate manual entries. 

The display normally consists of 25 lines of 80 columns 
each; 40-colunm lines are also supported by the color/ 
graphics adapter. Writing characters to the console 
(/dev/console) has an effect that depends on the charac- 
ters. All characters written to /dev/console are first 
processed by the terminal interface (see termio(M)). For 
example, mapping new-line characters to carriage return 
plus new-line and expanding tabs to spaces will be done 
before the following processing: 

X Where x is not one of the following, displays x. 

BEL Generates a bell (audible tone, no modulation). 

CR Places the cursor at column 1 of the current 

line. 

LF,VT Places the cursor at the same column of the next 
line (scrolls if the current line is line 25). 

FF Clears the screen and places the cursor at line 

1, colunm 1. 

BS Depends on the previous character: if a _ 

(underscore), see below; otherwise, if the cur- 
sor is not at colunm 1, it is moved to the left 
one position on the same line. If the cursor is 
at column 1 but not line 1, it is moved to 
column 79 of the previous line. Finally, if the 
cursor is at colunm 1, line 1, it is not moved. 
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BSx Sets the underscore attribute for the character 
X to be displayed. The underscore attribute for 
the color /graphics adapter is a red background 
with a white foreground. 

ESCx Where x is any of the 256 possible codes (except 
for c and [), displays that value interpreted. 
This is useful for using the full set of graph- 
ics available on the display. Note again that 
the characters are processed through the termi- 
nal interface prior to this escape sequence. 
Therefore, to get some of the possible 256 char- 
acters, it is necessary that the character not 
be post processed. The easiest way to accom- 
plish this is to turn off OPOST in the c oflag 
field (see termio(M)); however, this may have 
other side effects. 



This display can be controlled by means of ANSI X3.64 
escape sequences, which are specified sequences of charac- 
ters, preceded by the ASCII character ESC. The escape 
sequences, which work on either the monochrome or 
color/graphics adapter, are the following: 



ESCc Clears the screen and places the cursor at 

line 1, column 1. 

ESC[ n @ Insert character - inserts n blank places 

for n characters at the current cursor po- 
sition. 



ESC[ n A Cursor up - moves the cursor up n lines 

(default: n=l). 

ESC[ n B Cursor down - moves the cursor down n lines 

(default: n=l). 

ESC[ n C Cursor right - moves the cursor right n 

columns (default: n=l). 



ESCC n D Cursor left - moves the cursor left n 

columns (default: n=l). 



ESC[ n E Cursor next line - moves the cursor to 

column 1 of the next line, then down n-1 
lines (default: n=l). 



2 



DISPLAY(M) 



DISPLAY (M) 



ESC[ n F Cursor previous line - moves the cursor to 

column 1 of the current line, then up n 
lines (default: n=l). 



ESC[ n G Cursor horizontal position - moves the 

cursor to column n of the current line 
(default: n=l). 



ESC[ n ; m H Position cursor - moves the cursor to 
column m of line n (default: n=l). 



ESC[ n J Erase window - erases from the current 

cursor position to the end of the window if 
n=0, from the beginning of the window to 
the current cursor position if n=l, and the 
entire window if n=2 (default: n=l). 



ESC[ n K Erase line - erases from the current cursor 

position to the end of the line if n=0, 
from the beginning of the line to the cur- 
rent cursor position if n=l, and the entire 
line if n=2 (default: n=l). 



ESC[ n L Inserts n lines at the current cursor 

position (default: n=l). 

ESC[ n M Deletes n lines at the current cursor 

position (default: n=l). 

ESC[ n P Deletes n characters from a line starting 

at the current cursor position (default: 
n=l). 



ESC[ n S Scroll up - scrolls the characters in the 

current window up n lines. The bottom n 
lines are cleared to blanks (default: 
n=l). 

ESC[ n T Scroll down - scrolls the characters in the 

current window down n lines. The top n 
lines are cleared to blanks (default: n=l). 



ESC[ n X Erase character - erases n character 

positions starting at the current cursor 
position (default: n=l). 
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ESC [ Ps ; Ps; ... m 

Character attributes - each Ps is one of 
the following characters; multiple charac- 
ters are separated by semicolons. These 
parameters apply to successive characters 
being displayed, in an additive manner 
(e.g., both bold and underscoring can be 
selected). Only the parameters through 7 
apply to the monochrome adapter; all param- 
eters apply to the color/graphics adapter. 
(Default: Ps=0.) 



Ps Meaning 



0 all attributes off (normal display) 

(white foreground with black background) 

1 bold intensity 

4 underscore on 

(white foreground with red background on color) 

5 blink on 

7 reverse video 

10 selects the primary font 

11 selects the first alternate font; lets ASCII 

characters less than 32 be displayed as ROM char- 
acters 

12 selects a second alternate font; toggles high bit 

of extended ASCII code before displaying as ROM 
characters 



30 


black 


(gray) 


foreground 


31 


red 


(light red) 


foreground 


32 


green 


(light green) 


foreground 


33 


brown 


(yellow) 


foreground 


34 


blue 


(light blue) 


foreground 


35 


magenta 


(light magenta) 


foreground 


36 


cyan 


(light cyan) 


foreground 


37 


white 


(bright white) 


foreground 


40 


black 


(gray) 


background 


41 


red 


(light red) 


background 


42 


green 


(light green) 


background 


43 


brown 


(yellow) 


background 


44 


blue 


(light blue) 


background 


45 


magenta 


(light magenta) 


background 


46 


cyan 


(light cyan) 


background 


47 


white 


(bright white) 


background 
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Note that for character attributes 30 through 37, the 
color selected for foreground will depend on whether the 
bold intensity attribute (1) is currently on. If not, the 
first color listed will result; otherwise the second color 
listed will result. 

Similarly, for character attributes 40-47, the color se- 
lected for background will depend on whether the blink 
attribute (5) is currently on. The color selected for 
background also depends on whether blinking is enabled in 
color mode byte or no blinking is selected (see the 
MODE_BLINK and M0DE_BG16 bits in the color mode byte 
defined below). If the blink attribute is not on, then the 
first color listed will result. If the blink attribute is 
not on, and blinking is enabled, then the first color 
listed will result and it will blink. If the blink attri- 
bute is on, and no blinking is enabled, then the second 
color listed will result. 



loctl calls 

The display driver supports ioctl(S) calls of the form: 

ioctl(/nedes, command, arg) 

filedes is a valid open file descriptor. 
command is one of the commands listed below. 
arg is the argument of command. The type of arg is 

specific to the command in use. 

The following is a list of valid ioctl commands for dis- 
play adapters. These commands and structures are defined 
in sys/kd.h. 

KDDISPTYPE 

Returns information about the current display adap- 
ter. The argument is the address of a structure 
(defined in sys/kd.h) of the following type: 

struct kd_disparam { 
long type; 
char *addr; 
ushort ioaddr[]; 

) 
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type 



describes the type of adapter installed, 
and is one of: KD MONO, KD HERCULES, 
KD CGA, or KD EGA. 



addr 



is the physical address of the display mem- 
ory for this adapter. 



ioaddr 



is a list of I/O addresses valid for this 
adapter. 



KDGETMODE 

Returns the current display mode. Arg is an integer, 
whose values are one of the following: 



KDSETMODE 

Sets the current display mode. Arg is an integer, 
whose values are one of those defined above for 
KDGETMODE. Note, the user is responsible for pro- 
gramming the color /graphics adapter registers for the 
appropriate graphical state. 

KDADDIO 

Adds I/O port address to list of valid video adapter 
addresses. Argument is an unsigned short type which 
should contain a valid port address for the installed 
video adaptor. 

KDDELIO 

Deletes I/O port address from list video adaptor ad- 
dresses. Argument is an unsigned short type which 
should contain a valid port address for the installed 
video adaptor. 

KDENABIO 

Enables ins and outs to video adaptor ports. No 
argument. 

KDDISABIO 

Disables ins and outs to video adaptor ports. No 
argument. 



KDTEXT 

KD GRAPHICS 



Text mode 
Graphics Mode 
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KDMAPDISP 

Maps the display memory for the current adapter in 
the user's data space. Argument is a pointer to 
structure type "kd_memloc." Structure definition is: 

struct kd_memloc { 

char *vaddr; /* virtual address to map to */ 
char *physaddr;/* physical address to map from */ 
long length; /* size in bytes to map */ 
long ioflg; /* enable i/o addresses if set */ 

} 

vaddr contains a paged-aligned virtual address in the 
user's data space. To map the display memory for a 
monographic adapter requires 4 Kbytes. In order to 
map the display memory, the user must first use 
KDSETMODE to place the adapter into graphics mode 
and also use the VT_SETMODE option (see vt(M)) to 
set the virtual terminal mode to VT_PROCESS. In- 
cluded in this section is a sample code fragment 
showing how to correctly map the screen memory into 
user data space. 

KDUNMAPDISP 

Unmaps the display adapter memory from user data 
space. 

The following code fragment details how to map the 
display adapter memory into user data so the screen 
can be accessed via memory references in user code. 

#include <sys/tYpes . h> 
#include <SYs/immu.h> 
#include <SYs/at_ansi . h> 
#include <sYs/kd.h> 
#include <sYs/vt.h> 

unsigned char d[0x2000] ; /* allocate 2 pages of data */ 
unsigned char *c; 
int fd; 



7 



DISPLAY(M) 



DISPLAY(M) 



struct vt_mode vt ; 
struct kd_memloc mp; 
struct screen { 

char ch; 

char attr; 
) *scr; 



/* assign a page-aligned address. 

* Starting in the middle of a 2*pagesize array assures 

* it will contain 1 page-aligned address with 1 page of 

* data following. 
*/ 

c = (unsigned char * ) ( (long) (&d[sizeof (d) /2] ) fi (NBPP-1)) 
if (ioctl(fd,VT_GETMODE,&vt) == -1 ) 

exit(l) ; 
vt.mode = VT_PROCESS; 

/* set virtual terminal process control mode */ 
if (ioctl(fd,VT_SETMODE,&vt) == -1 ) 
exit(l); 

/* set adapter in graphics mode */ 
if (ioctl(fd,KDSETMODE,KD_GRAPHICS) == -1 ) 
exit(l) ; 

/* virtual address to map to */ 

mp.vaddr = (char unsigned *)c; 

/* start of monographic display memory */ 

mp.physaddr = (char *)MONO_BASE; 

/* length of monograph display memory */ 

mp. length = (long)MONO_SIZE; 

mp.ioflg = (long)O; 

/* map the display memory into user data space */ 
if (ioctl(fd,KDMAPDISP,&mp) ) 
exit(l); 

/* start of screen memory */ 
scr = (struct screen *)c; 
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/* The layout of screen memory is: 

* For each character: 

* 1 data byte 

* 1 attribute byte 
*/ 

scr->ch = ... 
scr->attr = .... 



/* Unmap display and reset modes */ 
ioctl(fd,KDUNMAPDISP) ; 
ioctl(fd,KD_TEXT) ; 
vt.mode = VT_AUTO; 
ioctl(fd,VT_SETMODE,&vt) ; 



VTOPENQRY 

VT_GETMODE 

VTSETMODE 

VTRELDISP 

VT_ACTIVATE 

These ioctl(S) options are used for controlling vir- 
tual terminals. Refer to vt(M) for their defini- 
tions. 



Files 

/dev/console 



See Also 

stty(C), ioctl(S), keyboard(M), termio(M), vt(M) 
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Name 

environ - The user environment. 



Description 

The user environment (environ) is a collection of informa- 
tion about a user, such as his login directory, mailbox, 
and terminal type. The environment is stored in special 
"environment variables," which can be assigned character 
values, such as names of files, directories, and termi- 
nals. These variables are automatically made available to 
programs and commands that you can invoke. The commands 
can then use the values to access your files and terminal. 



Options 

HOME Names the user's login directory. Initially, 

HOME is set to the login directory given in the 
user's passwd file entry. 

PATH Defines the search path for the directories con- 
taining commands. The system searches these 
directories whenever a user types a command 
without giving a full pathname. The search path 
is one or more directory names separated by 
colons {:). Initially, PATH is set to 
:/bin;/usr/bin. 

TERM Defines the type of terminal being used. This 
information is used by conmiands such as more 
which rely on information about the capabilities 
of the user's terminal. The variable may be set 
to any valid terminal name (see terminals(M)) 
directly or by using the tset(C) command. 

TZ Defines time zone information. This information 

used by date(C) to display the appropriate time. 
The variable may have any value of the form 
xxxnzzz where xxx is standard local time zone 
abbreviation, n is the difference in hours from 
GMT, and 222 is the daylight-saving local time 
zone abbreviation (if any). For example, 
EST5EDT. The difference for a location east of 
England can be given as a negative number. 
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The environment can be changed by assigning a new value 
to a variable. An assignment has the form 

name=value 

For example, the assignment: 

TERM=altos3 

sets the TERM variable to an Altos III. When using the 
standard shell (sh(C)), the new value can be "exported" to 
each subsequent invocation of a shell by exporting the 
variable with the export command (see sh(C)) or by using 
the env(C) command. Users of the C-shell (csh(C)) can 
set and export a variable with the setenv command (see 
csh(C)). 

A user may also add variables to the environment, but must 
be sure that the new names do not conflict with exported 
shell variables such as MAIL, PSl, PS2, and IPS. Placing 
assignments in the .profile file is a useful way to change 
the environment automatically before a session begins. 

Note that the environment is made available to all pro- 
grams as a string of arrays. Each string has the form: 

name=value 

where the name is the name of an exported variable and 
the value is the variable's current value. For programs 
started with a exec(S) call, the environment is available 
through the external pointer environ. For other programs, 
individual variables in environment are available through 
getenv(S) calls. 



See Also 

login(G), sh(C), profile(M), and getenv(S) in the 
Reference (CP, S, F) 
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Name 

errprint - Displays error log contents. 



Syntax 

/etc/errprint [date] 



Description 

Errprint displays the error messages logged by the 
strerr(M) daemon for a particular date. The optional date 
argument may be specified on the conmiand line in any of 
the following formats: 

mm dd 
mm-dd 
mm/dd 

monthname dd 

If no date is specified, the current date is used. 

For ease of viewing, the only fields displayed for each 
error message are the time of day and the text of the mes- 
sage. The remaining fields found in the log file are not 
displayed. The output is automatically piped through 
more(C). 



Files 

/usr/adm/streams/error. mm-dd 
/usr/lib/errstrip. awk 



See Also 

strerr(M) 
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Name 



ff - Fast find: lists file names and statistics for a 
file system. 



Ff reads the i-list and directories of the special file, 
assuming it is a file system. I node data is saved for 
files which match the selection criteria. Output consists 
of the path name for each saved inode, plus other file 
information requested using the print options below. Out- 
put fields are positional. The output is produced in 
inode order; fields are separated by tabs. The default 
line produced by ff is: 

path-name i-numher 

With all options enabled, output fields would be: 

path-name i-numher size uid 

The argument n in the option descriptions that follow is 
used as a decimal integer (optionally signed), where +n 
means more than n, -n means less than n, and n means 
exactly n. A day is defined as a 24 hour period. 

-I Do not print the inode number after each 



Syntax 



/etc/ff [options] special 



Description 



path name. 



-1 



Generate a supplementary list of all path 
names for multiply-linked files. 



-p prefix 



The specified prefix will be added to each 
generated path name. The default is . 
(dot). 



-s 



Print the file size, in bytes, after each 
path name. 
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-u Print the owner's login name after each 

path name. 

-a n Select if the inode has been accessed in n 

days. 

-m n Select if the inode has been modified in n 

days. 

-c n Select if the inode has been changed in n 

days. 

-n file Select if the inode has been modified more 

recently than the argument file. 

-i inode-list Generate names for only those inodes speci- 
fied in inode-list. 



See Also 

find(C), ncheck(M) 



Notes 

If the -1 option is not specified, only a single path name 
out of all possible ones is generated for a multiply- 
linked inode. If -1 is specified, all possible names for 
every linked file on the file system are included in the 
output. However, no selection criteria apply to the names 
generated. 
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Name 

filesystem - Format of a system volume. 



Syntax 

^include <sys/filsys.h> 
^include <sys/types.h> 
l^include <sys/param.h> 
^include <sys/inode.h> 
/^include <sys/ino.h> 



Description 

Every file system storage volume (e.g., a hard disk) has a 
common format for certain vital information. Every such 
volume is divided into a certain number of 512 byte sec- 
tors. Sector 0 is unused and is available to contain a 
bootstrap program or other information. 

Sector 1 is the super-block. The format of a super-block 
is described in /usr/include/sys/filsys.h. In that in- 
clude file, sjsize is the address of the first data block 
after the i-list. The i-list starts in logical block 2; 
thus the i-list is s_isize-2 blocks long. S fsize is the 
first block not potentially available for allocation to a 
file. These numbers are used by the system to check for 
bad block numbers. If an "impossible" block number is 
allocated from the free list or is freed, a diagnostic is 
written on the console. Moreover, the free array is 
cleared so as to prevent further allocation from a presum- 
ably corrupted free list. 

The free list for each volume is maintained as follows. 
The sjree array contains, in s_/ree[l], 
s_free[s_nfree-l], up to NICFREE-1 numbers of free blocks 
S_/ree[0] is the block number of the head of a chain of 
blocks constituting the free list. The first long in each 
free-chain block is the number (up to NICFREE) of 
free-block numbers listed in the next NICFREE longs of 
this chain member. The first of these NICFREE blocks is 
the link to the next member of the chain. To allocate a 
block: decrement s_n/ree, and the new block is 
sjreeisjxfree]. If the new block number is 0, there are 
no blocks left, so give an error. If s nfree becomes 0, 
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read in the block named by the new block number, replace 
sjifree by its first word, and copy the block numbers in 
the next NICFREE longs into the sjree array. To free a 
block, check if s nfree is 50; if so, copy s nfree and the 
sfree array into it, write it out, and set snfree to 0. 
In any event set s_free[s_nfree] to the freed block's num- 
ber and increment s nfree. 

SJtfree is the total free blocks available in the file 
system. 

S ninode is the number of free i-numbers in the s inode 
array. To allocate an inode: if s ninode is greater than 
0, decrement it and return s_inode[s_ninode]. If it was 

0, read the i-list and place the numbers of all free 
inodes (up to NICINOD) into the s inode array, then try 
again. To free an inode, provided s ninode is less than 
NICINOD, place its number into s_inode[s_ninode] and in- 
crement s ninode. If s ninode is already NICINOD, do not 
bother to enter the freed inode into any table. This list 
of inodes only speeds up the allocation process. The in- 
formation about whether the inode is really free is main- 
tained in the inode itself. 

S tinode is the total number of free inodes available in 
the file system. 

S_flock and s ilock are flags maintained in the core copy 
of the file system while it is mounted and their values on 
disk are immaterial. The value of sjmod on disk is also 
immaterial, and is used as a flag to indicate that the 
superblock has changed and should be copied to the disk 
during the next periodic update of file system informa- 
tion. 

S ronly is a read-only flag used to indicate write- 
protection. 

S time is the last time the super-block of the file system 
was changed, and is a doubleprecision representation of 
the number of seconds that have elapsed since 00:00 Jan. 

1, 1970 (GMT). During a reboot, the s time of the 
super-block for the root file system is used to set the 
system's idea of the time. 
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I -numbers begin at 1, and the storage for inodes begins in 
logical block 2. Inodes are 64 bytes long. Inode 1 is 
reserved for future use. Inode 2 is reserved for the root 
directory of the file system, but no other i-number has a 
built-in meaning. Each inode represents one file. For 
the format of an inode and its flags, see ino.h. 



Files 

/usr/include/sys/filsys.h 
/usr/include/sys/stat. h 
/usr/include/sys/types.h 
/usr/include/sys/param.h 
/usr/include/sys/inode. h 
/usr/include/sys/ino.h 



See Also 

fsck(C), mkfs(M) 
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Name 

fine - Fast incremental backup. 



Syntax 

/etc/fine [selection-criteria] file-system raw-tape 



Description 

Fine selectively copies the input file-system to the out- 
put raw-tape. The cautious will want to mount the input 
file-system read-only to insure an accurate backup, al- 
though acceptable results can be obtained in read-write 
mode. The tape must be previously labelled by labelit(C). 
The selection is controlled by the selection-criteria^ 
accepting only those inodes/files for whom the conditions 
are true. 

It is recommended that production of a fine tape be pre- 
ceded by the ff(M) command, and the output of ff be saved 
as an index of the tape's contents. Files on a fine tape 
may be recovered with the free(M) command. 

The argument n, in the selection-criteria that follow, is 
used as a decimal integer (optionally signed), where +n 
means more than n, -n means less than n, and n means ex- 
actly n. A day is defined as 24 hours. 

-a n True if the file has been accessed in n days. 

-m n True if the file has been modified in n days. 

-e n True if the inode has been changed in n days. 

-n file True for any file which has been modified more 
recently than the argument file. 



Examples 

To write a tape consisting of all files from file-system / 
modified in the last 48 hours: 

fine -m -2 /dev/root /dev/ret 
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ff(M), frec(M), labelit(C) and cpio(C) 
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Name 

free - Recovers files from a backup tape. 



Syntax 

/etc/free [-p path] [-f reqfile] raw tape 
inode number :name... 



Description 

Free recovers files from the specified raw tape backup 
tape written by volcopy(M) or finc(M), given their 
inode numbers. The data for each recovery request will be 
written into the file given by name. 



Options 

-p path Specifies a prefixing path (different from 

your current working directory). This will 
be prefixed to any names that are not fully 
qualified, i.e., that do not begin with / 
or ./. If any directories are missing in 
the paths of recovery names, they will be 
created. 

-f reqfile Specifies a file that contains recovery 

requests. The format is inode numbermame, 
one per line. 



Examples 

To recover a file, inode number 1216 when backed-up, into 
a file named junk in your current working directory, type: 

free /dev/ret 121 6: junk 

To recover files with inode_numbers 14156, 1232, and 3141 
into files /usr/src/cmd/a, /usr/src/cmd/b and 
/usr / joe/a. c, enter: 

free -p /usr/src/cmd /dev/rct 14156:a 1232:b 
3141:/usr/joe/a.c 
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See Also 

ff(M), finc(M), labelit(M), and cpio(C) 



Notes 

While paving a path (i.e., creating the intermediate di- 
rectories contained in a pathname), free can only recover 
inode fields for those directories contained on the tape 
and requested for recovery. 
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Name 



fsdb - File system debugger. 



Syntax 



/etc/fsdb special [ - ] 



Description 

Fsdb is used to patch up a damaged file system after a 
crash. It has conversions to translate block and inode 
numbers into their corresponding disk addresses. Also 
included are mnemonic offsets to access different parts of 
an inode. These greatly simplify the process of correct- 
ing control block entries or descending the file system 
tree. 

Fsdb contains several error-checking routines to verify 
inode and block addresses. These can be disabled if ne- 
cessary by invoking fsdb with the optional - argument or 
by the use of the O symbol. (Fsdb reads the i-size and 
f-size entries from the superblock of the file system as 
the basis for these checks.) 

Numbers are considered decimal by default. Octal numbers 
must be prefixed with a zero. During any assignment oper- 
ation, numbers are checked for a possible truncation error 
due to a size mismatch between source and destination. 

Fsdb reads a block at a time and will therefore work with 
raw as well as block I/O. A buffer management routine is 
used to retain commonly used blocks of data in order to 
reduce the number of read system calls. All assignment 
operations result in an immediate write-through of the 
corresponding block. 

The symbols recognized by fsdb are: 




absolute address 

convert from inode number to inode address 

convert to block address 

directory slot offset 

address arithmetic 

quit 
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O 

P 

f 

B 

W 

D 



=+ 



save, restore an address 
numerical assignment 
incremental assignment 
decremental assignment 
character string assignment 
error checking toggle 
general print facilities 
file print facility 
byte mode 
word mode 
double word mode 
escape to shell 



The print facilities generate a formatted output in var- 
ious styles. The current address is normalized to an ap- 
propriate boundary before printing begins. It advances 
with the printing and is left at the address of the last 
item printed. The output can be terminated at any time by 
typing the delete character. If a number follows the p 
symbol, that many entries are printed. A check is made to 
detect block boundary overflows since logically sequential 
blocks are generally not physically sequential. If a 
count of zero is used, all entries to the end of the cur- 
rent block are printed. The print options available are: 

i print as inodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

The f symbol is used to print data blocks associated with 
the current inode. If followed by a number, that block of 
the file is printed. (Blocks are numbered from zero.) 
The desired print option letter follows the block number, 
if present, or the f symbol. This print facility works 
for small as well as large files. It checks for special 
devices and that the block pointers used to find the data 
are not zero. 

Dots, tabs, and spaces may be used as function delimiters 
but are not necessary. A line with just a new-line char- 
acter will increment the current address by the size of 
the data type last printed. That is, the address is set 
to the next byte, word, double word, directory entry or 
inode, allowing the user to step through a region of a 
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file system. Information is printed in a format appropri- 
ate to the data type. Bytes, words and double words are 
displayed with the octal address followed by the value in 
octal and decimal. A .B or .D is appended to the address 
for byte and double word values, respectively. Direc- 
tories are printed as a directory slot offset followed by 
the decimal inode number and the character representation 
of the entry name. Inodes are printed with labeled fields 
describing each element. 

The following mnemonics are used for inode examination and 
refer to the current working inode: 



md mode 

In link count 

aid user ID number 

gid group ID number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

ct creation time 

mt modification time 

maj major device number 

min minor device number 

Examples 

386i Prints inode number 386 in an inode format. 

This now becomes the current working inode. 

ln=4 Changes the link count for the working 

inode to 4. 

ln=+l Increments the link count by 1. 

fc Prints, in ASCII, block zero of the file 

associated with the working inode. 

21. fd Prints the first 32 directory entries for 

the root inode of this file system. 

dSi.fc Changes the current inode to that associ- 



ated with the 5th directory entry (numbered 
from zero) found from the above command. 
The first logical block of the file is then 
printed in ASCII. 
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512B.p0o Prints the superblock of this file system 

in octal. 



2i.a0b.d7=3 Changes the inode number for the seventh 
directory slot in the root directory to 3. 
This example also shows how several opera- 
tions can be combined on one command line. 



d7.nm="name" Changes the name field in the directory 
slot to the given string. Quotes are op- 
tional when used with nm if the first char- 
acter is alphabetic. 



a2b.p0d Prints the third block of the current inode 

as directory entries. 



See Also 



fsck(C), and dir(S), fs(S) in the Reference (CP, S, F) 
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Name 

fsinfo - Reports information about a file system. 



Syntax 

fsinfo options file-system 



Description 

The fsinfo command displays information about the given 
filesystem. All the values returned by fsinfo are ex- 
pressed in 512 byte blocks. 



Options 

-f Returns the free block count of the file-system. 

-i Returns the total number of blocks of inodes in a 
file-system. 

-1 Returns the total number of free blocks in the 
file-system. 

-s Performs a sanity check on the file-system. The re- 
turn code will be 0 if the sanity check completes 
successfully. A positive number is returned on fail- 
ure. 



See Also 
df(M) 
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Name 

fsstat - Reports file system status. 



Syntax 

/etc/fsstat special ^ile 



Description 

Fsstat reports on the status of the file system on 
special_file. During startup, this command is used to 
determine if the file system needs checking before it is 
mounted. Fsstat succeeds if the file system is unmounted 
and appears okay. For the root file system, it succeeds 
if the file system is active and not marked bad. 



Diagnostics 

The command has the following exit codes: 

0 - the file system is not mounted and appears okay, 

(except for root where 0 means mounted and okay). 

1 - the file system is not mounted and needs to be 

checked. 

2 - the file system is mounted. 

3 - the command failed. 
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Name 

fstab - File system table. 
Description 

The etc/fstab file contains information about file systems 
for use by mount(C) and mountall(C). Each entry in 
/etc/fstab has the following format: 

column 1 block special file name of file system 

column 2 mount-point directory 

column 3 "-r" if to be mounted read-only 

column 4 (optional) file system type string 

column 5+ ignored 

White-space separates columns. Lines beginning with 

are comments. Empty lines are ignored. 

A file system table might read: 

/dev/hdlb /usr2 

Files 

/etc/fstab 

See Also 

mount(C), mountain C) 
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Name 

fstyp - Determines file system identifier. 



Syntax 

/etc/fstyp special 



Description 

Fstyp allows the user to determine the file system identi- 
fier of mounted or unmounted file systems using heuristic 
programs. The file system type is required by mount(S) 
and sometimes by mount(M) to mount file systems of differ- 
ent types. 

The directory /etc/fstyp. d contains a program for each 
file system type to be checked; each of these programs 
applies some appropriate heuristic to determine whether 
the supplied special file is of the type for which it 
checks. If it is, the program prints on standard output 
the usual file-system identifier for that type and exits 
with a return code of 0; otherwise it prints error mes- 
sages on standard error and exits with a non-zero return 
code. Fstyp runs the programs in /etc/fstyp. d in alpha- 
betical order, passing special as an argument; if any pro- 
gram succeeds, its file-system type identifier is printed 
and fstyp exits immediately. If no program succeeds, 
fstyp prints "Unknown fstyp" to indicate failure. 



Notes 

The use of heuristics implies that the result of fstyp is 
not guaranteed to be accurate. 



See Also 

mount(M), and mount(S), sysfs(S) in the Reference (CP, 
S, F) 
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Name 

fuser - Identifies processes using a file or file struc- 
ture. 



Syntax 

/etc/fuser [-ku ] file... \ resource... [-] [[-ku] 
file... I resource...] 



Description 

Fuser outputs the process IDs of the processes that are 
using the files or remote resources specified as argu- 
ments. Each process ID is followed by a letter code, in- 
terpreted as follows if the process is using the file as: 

c Current directory 

p Parent of its current directory (only when the file 
is being used by the system) 

r Root directory 

For block special devices with mounted file systems, all 
processes using any file on that device are listed. For 
remote resource names, all processes using any file asso- 
ciated with that remote resource (Remote File Sharing) are 
reported. (Fuser cannot use the mount point of the remote 
resource; it must use the resource name.) For all other 
types of files (text files, executables, directories, de- 
vices, etc.) only the processes using that file are re- 
ported. 

The following options may be used with fuser: 

-u The user login name, in parentheses, also follows the 
process ID. 

-k The SIGKILL signal is sent to each process. Since 
this option spawns kills for each process, the kill 
messages may not show up immediately (see kill(S)). 
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If more than one group of files are specified, the options 
may be respecified for each additional group of files. A 
lone dash cancels the options currently in force; then, 
the new set of options applies to the next group of files. 

The process IDs are printed as a single line on the stan- 
dard output, separated by spaces and terminated with a 
single new line. All other output is written on standard 
error. 

You cannot list processes using a particular file from a 
remote resource mounted on your machine. You can only 
use the resource name as an argument. 

Any user with permission to read /dev/kmem and /dev/mem 
can use fuser. Only the super-user can terminate another 
user's process. 



Files 



/unix 

/dev/kmem 
/dev/mem 



For system namelist 
For system image 
Also for system image 



See Also 



mount(C), ps(C) 

kill(S), signal(S) in the Reference (CP, S, F) 
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Name 

getty - Sets terminal type, modes, speed, and line disci- 
pline. 



Syntax 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type 

[ linedisc ] ] ] 
/etc/getty -c file 



Description 

Getty is a program that is invoked by init(M). It is the 
second process in the series, (init-getty-login-shell) 
that ultimately connects a user with the operating system. 
It can only be executed by the super-user; that is, a pro- 
cess with the user-ID of root. Initially getty prints the 
login message field for the entry it is using from 
/etc/gettydefs. Getty reads the user's login name and 
invokes the login(C) command with the user's name as argu- 
ment. While reading the name, getty attempts to adapt the 
system to the speed and type of terminal being used. It 
does this by using the options and arguments specified. 

Line is the name of a tty line in /dev to which getty is 
to attach itself. Getty uses this string as the name of a 
file in the /dev directory to open for reading and writ- 
ing. Unless getty is invoked with the -h flag, getty will 
force a hangup on the line by setting the speed to zero 
before setting the speed to the default or specified 
speed. The -t flag plus timeout (in seconds), specifies 
that getty should exit if the open on the line succeeds 
and no one types anything in the specified number of sec- 
onds. 

Speedf the optional second argument, is a label to a speed 
and tty definition in the file /etc/gettydefs. This defi- 
nition tells getty at what speed to initially run, what 
the login message should look like, what the initial tty 
settings are, and what speed to try next should the user 
indicate that the speed is inappropriate (by pressing 
MilIJk\liA»ISM). The default speed is 300 baud. 
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Type, the optional third argument, is a character string 
describing to getty what type of terminal is connected to 
the line in question. Getty recognizes the following 
types: 



The default terminal is none; i.e., any crt or normal ter- 
minal unknown to the system. Also, for terminal type to 
have any meaning, the virtual terminal handlers must be 
compiled into the operating system. They are available, 
but not compiled in the default condition. 

Linedisc, the optional fourth argument, is a character 
string describing which line discipline to use in communi- 
cating with the terminal. Again the hooks for line disci- 
plines are available in the operating system but there is 
only one presently available, the default line discipline, 
LDISCO. 

When given no optional arguments, getty sets the speed of 
the interface to 300 baud, specifies that raw mode is to 
be used (awaken on every character), that echo is to be 
suppressed, either parity allowed, new-line characters 
will be converted to carriage return-line feed, and tab 
expansion performed on the standard output. It types the 
login message before reading the user's name a character 
at a time. If a null character (or framing error) is re- 
ceiv ed, it is assu med to be the result of the user pres- 
sing Bs{7!S!iyit'HB . This will cause getty to attempt the 
next speed in the series. The series that getty tries is 
determined by what it finds in /etc/gettydefs. 

After the user's name has been typed in, it is terminated 
by a new-line or carriage-return character. The latter 
results in the system being set to treat carriage returns 
appropriately (see ioctl(S)). 



vt61 
vtlOO 
hp45 
clOO 



none 
ds40-l 



tektronix,tek 



default 

Dataspeed40/1 
Tektronix 
DEC vt61 
DEC VtlOO 
Hewlett-Packard 45 
Concept 100 
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The user's name is scanned to see if it contains any 
lower-case alphabetic characters; if not, and if the name 
is non-empty, the system is told to map any future 
upper-case characters into the corresponding lower-case 
characters. 

Finally, login is executed with the user's name as an ar- 
gument. Additional arguments may be typed after the login 
name. These are passed to login, which will place them in 
the environment (see login(C)). 

A check option is provided. When getty is invoked with 
the -c option and file, it scans the file as if it were 
scanning /etc/gettydefs and prints out the results to the 
standard output. If there are any unrecognized modes or 
improperly constructed entries, it reports these. If the 
entries are correct, it prints out the values of the var- 
ious flags. See ioctl(S) to interpret the values. Note 
that some values are added to the flags automatically. 



Files 

/etc/gettydefs 
/etc/issue 



See Also 

ct(C), gettydefs(M), init(M), inittab(M), login(C), 
tty(M), and ioctl(S) in the Reference (CP, S, F) 



Notes 

While getty understands simple single character quoting 
conventions, it is not possible to quote certain special 
control characters used by getty. Thus, you cannot login 
via getty and type a ff, @, /, !, _, backspace, "U, "D, or 
& as part of your login name or arguments. Getty uses 
them to determine when the end of the line has been 
reached, which protocol is being used, and what the erase 
character is. They will always be interpreted as having 
their special meaning. 
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Name 

gettydefs - Speed and terminal settings used by getty. 



Description 

The /etc/gettydefs file contains information used by 
getty (M) to set up the speed and terminal settings for a 
line. It supplies information on what the login prompt 
should look like. It also su pplies the speed to try next 
if the user types a BilifiR^M character, which indicates the 
current speed is not correct. 

Each entry in /etc/gettydefs has the following format: 

labeUinitial-flags^final-flagslflogin-proTnptlf next-label 

Each entry is followed by a blank line. The various 
fields can contain quoted characters of the form \b, \n, 
\c, etc., as well as \nnn, where nnn is the octal value of 
the desired character. The various fields are: 

label This is the string against which 

getty (M) tries to match its second 
argument. It is often the speed, such 
as 1200, at which the terminal is sup- 
posed to run, but it need not be (see 
below). 

initial-flags These flags are the initial ioctl(S) 

settings to which the terminal is to 
be set if a terminal type is not spe- 
cified to getty. The flags that getty 
understands are the same as the ones 
listed in /usr/include/sys/termio.h 
(see termio(M)). Normally only the 
speed flag is required in the 
inital-flags. Getty automatically 
sets the terminal to raw input mode 
and takes care of most of the other 
flags. The initial-flag settings re- 
main in effect until getty executes 
login(C). 
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final-flags 



These flags take the same values as 
the initial-flags and are set just 
prior to getty executes login. The 
speed flag is again required. The 
composite flag SANE takes care of 
most of the other flags that need to 
be set so that the processor and ter- 
minal are communicating in a rational 
fashion. The other two commonly spe- 
cified final-flags are TAB3, so that 
tabs are sent to the terminal as spaces, 
and HUPCL, so that the line is hung 
up on the final close. 



login-prompt 



This entire field is printed as the 
login-prompt. Unlike the above fields 
where white space is ignored (a space, 
tab, or newline), they are included in 
the login-prompt field. 



next-label 



If this entry does not specify the 
desired speed, indicated by the user 
typing a break character, then getty 
will search for the entry with 
next-label as its label field and set 
up the terminal for those settings. 
Usually, a series of speeds are linked 
together in this fashion, into a 
closed set. For instance, 2400 linked 
to 1200, which in turn is linked to 
300, which finally is linked to 2400. 



If getty is called without a second argument, then the 
first entry of /etc/gettydefs is used, and is the default 
entry. It is also used if getty cannot find the specified 
label. If /etc/gettydefs itself is missing, there is one 
entry built into the command which will bring up a ter- 
minal at 300 baud. 



After making or modifying /etc/gettydefs, run it through 
getty with the check option to be sure there are no 
errors. 
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/etc/gettydefs 
See Also 

getty(M), termio(M), login(C), uugetty(M) 
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Name 

group - Format of the group file. 



Description 

The /etc/group file contains the following information: 

• Group name 

• Encrypted password (optional) 

• Numerical group ID 

• Comma-separated list of all users allowed in the 
group 

This is an ASCII file. The fields are separated by 
colons; each group is separated from the next by a new- 
line. If the password field is empty, then you are not 
prompted for a password, when using the newgrp(C) com- 
mand. 

This file resides in directory /etc. Because of the en- 
crypted passwords, it can and does have general read per- 
missions and can be used, for example, to map numerical 
group IDs to names. 



See Also 

passwd(M) 



1 



HALTSYS(C) 



HALTSYS(C) 



Name 

haltsys - Closes out the file systems and halts the CPU. 



Syntax 

/etc/haltsys 



Description 

You must be the super-user to access this command. 

The haltsys command immediately terminates the operating 
system and should only be used if a system problem pre- 
vents the running of shutdown. Do not run haltsys in mul- 
tiuser mode and when other users are on the system. Since 
haltsys takes effect immediately, user processes should be 
killed beforehand (see kill(C)). 



Related Commands 

kill(C), ps(C), shutdown(M) 
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Name 

infocmp - Compares or prints out terminfo descriptions. 



Syntax 

infocmp [-d] [-c] [-n] [-1] [-L] [-C] [-r] [-u] 
[-S d|i|l|c] [-V] [-V] [-1] [-W width] 
[-A directory] [-B directory] [termname ...] 



Description 

Infocmp can be used to compare a binary terminfo(M) entry 
with other terminfo entries, rewrite a terminfo(M) de- 
scription to take advantage of the use= terminfo field, or 
print out a terminfo (M) description from the binary file 
(term(M)) in a variety of formats. In all cases, the 
boolean fields will be printed first, followed by the nu- 
meric fields, followed by the string fields. 



Default Options 

If no options are specified and zero or one termnames are 
specified, the -I option will be assumed. If more than 
one termname is specified, the -d option will be assumed. 



Comparison Options [-d] [-c] [-n] 

Infocmp compares the terminfo(M) description of the first 
terminal termname with each of the descriptions given by 
the entries for the other terminal's termnames. If a cap- 
ability is defined for only one of the terminals, the 
value returned will depend on the type of the capability: 
F for boolean variables, -1 for integer variables, and 
NULL for string variables. 

-d Produce a list of each capability that is different. 
In this manner, if one has two entries for the same 
terminal or similar terminals, using infocmp will 
show what is different between the two entries. This 
is sometimes necessary when more than one person pro- 
duces an entry for the same terminal and one wants to 
see what is different between the two. 
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-c Produce a list of each capability that is common be- 
tween the two entries. Capabilities that are not set 
are ignored. This option can be used as a quick 
check to see if the -u option is worth using. 

-n Produce a list of each capability that is in neither 
entry. If no termnames are given, the environment 
variable TERM will be used for both of the termnames. 
This can be used as a quick check to see if anything 
was left out of the description. 



Source Listing Options [-1] [-L] [-C] [-r] 

The -I, -L, and -C options will produce a source listing 
for each terminal named. 

-I Use the terminfo(M) names 

-L Use the long C variable name listed in <term.h> 
-C Use the termcap names 

-r When using -C, put out all capabilities in termcap 
form 

If no termnames are given, the environment variable TERM 
will be used for the terminal name. 

The source produced by the -C option may be used directly 
as a termcap entry, but not all of the parameterized 
strings may be changed to the termcap format. Infocmp 
will attempt to convert most of the parameterized informa- 
tion, but that which it doesn't will be plainly marked in 
the output and commented out. These should be edited by 
hand. 

All padding information for strings will be collected to- 
gether and placed at the beginning of the string where 
termcap expects it. Mandatory padding (padding informa- 
tion with a trailing '/') will become optional. 

All termcap variables no longer supported by terminfo(M), 
but which are derivable from other terminfo(M) variables, 
will be output. Not all terminfo(M) capabilities will be 
translated; only those variables which were part of 
termcap will normally be output. 
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Specifying the -r option will take off this restriction, 
allowing all capabilities to be output in termcap form. 

Note that because padding is collected to the beginning of 
the capability, not all capabilities are output, mandatory 
padding is not supported, and termcap strings were not as 
flexible, it is not always possible to convert a 
terminfo(M) string capability into an equivalent termcap 
format. Not all of these strings will be able to be con- 
verted. A subsequent conversion of the termcap file back 
into terminfo(M) format will not necessarily reproduce the 
original terminfo(M) source. 

Some common terminfo parameter sequences, their termcap 
equivalents, and some terminal types which commonly have 
such sequences, are: 



Terminfo Termcap Representative Terminals 



%pl%c %. adm 

%pl%cl %d hp, ANSI standard, vtlOO 

%pl%'x'%+%c %+x concept 

%i %i ANSI standard, vtlOO 

%pl%?%'x'%>%t%pl%'y'%+%; %>xy concept 

%p2 is printed before %pl %r hp 



Use= Option [-u] 

-u Produce a terminfo(M) source description of the first 
terminal termname which is relative to the sum of the 
descriptions given by the entries for the other ter- 
minals termnames. It does this by analyzing the dif- 
ferences between the first termname and the other 
termnames and producing a description with use= 
fields for the other terminals. In this manner, it 
is possible to retrofit generic terminfo entries into 
a terminal's description. Or, if two similar ter- 
minals exist, but were coded at different times or by 
different people so that each description is a full 
description, using infocmp will show what can be done 
to change one description to be relative to the other. 
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A capability will get printed with an at-sign (@) if it no 
longer exists in the first termname, but one of the other 
termname entries contains a value for it. A capability's 
value gets printed if the value in the first termname is 
not found in any of the other termname entries, or if the 
first of the other termname entries that has this capabil- 
ity gives a different value for the capability than that 
in the first termname. 

The order of the other termname entries is significant. 
Since the terminfo compiler tic(C) does a left-to-right 
scan of the capabilities, specifying two use= entries that 
contain differing entries for the same capabilities will 
produce different results depending on the order in which 
the entries are given. Infocmp will flag any such incon- 
sistencies between the other termname entries as they are 
found. 

Alternatively, specifying a capability after a use= entry 
that contains that capability will cause the second speci- 
fication to be ignored. Using infocmp to recreate a de- 
scription can be a useful check to make sure that every- 
thing was specified correctly in the original source de- 
scription. 

Another error that does not cause incorrect compiled 
files, but will slow down the compilation time, is speci- 
fying extra use= fields that are superfluous. Infocmp 
will flag any other termname use= fields that were not 
needed. 



Other Options [-s d|i|l|c] [-v] [-V] [-1] [-w width] 

-s Sort the fields within each type according to the 
argument below: 

d Leave fields in the order that they are stored 
in the terminfo database. 

i Sort by terminfo name. 

1 Sort by the long C variable name. 

c Sort by the termcap name. 
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If no -s option is given, the fields printed out will be 
sorted alphabetically by the terminfo name within each 
type, except in the case of the -C or the -L options, 
which cause the sorting to be done by the termcap name or 
the long C variable name, respectively. 

-V Print out tracing information on standard error as 
the program runs. 

-V Print out the version of the program in use on stan- 
dard error and exit. 

-1 Cause the fields to printed out one to a line. 

Otherwise, the fields will be printed several to a 
line to a maximum width of 60 characters. 

-w Change the output to width characters. 



Changing Databases [-A directory] [-B directory] 

The location of the compiled terminfo (M) database is taken 
from the environment variable TERMINFO. If the variable 
is not defined, or the terminal is not found in that loca- 
tion, the system terminfo(M) database, usually in 
/usr/lib/terminfo, will be used. The options -A and -B 
may be used to override this location. The -A option will 
set TERMINFO for the first termname and the -B option 
will set TERMINFO for the other termnames. With this, 
it is possible to compare descriptions for a terminal with 
the same name located in two different databases. This is 
useful for comparing descriptions for the same terminal 
created by different people. Otherwise the terminals 
would have to be named differently in the terminfo(M) 
database for a comparison to be made. 



Files 

/usr/lib/terminfo/?/* Compiled terminal description 

database 
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Diagnostics 

malloc is out of space! 

There was not enough memory available to process all 
the terminal descriptions requested. Run infocmp 
several times, each time including a subset of the 
desired termnames. 

use= order dependency found: 

A value specified in one relative terminal specifica- 
tion was different from that in another relative ter- 
minal specification. 

'use=term' did not add anything to the description. 

A relative terminal name did not contribute anything 
to the final description. 

must have at least two terminal names for a comparison to 
be done. 

The -u, -d and -e options require at least two 
terminal names. 



See Also 

tic(C), curses(S), term(M), terminfo{M), captoinfo(M) 



Note 

The termcap database (from earlier releases of UNIX Sys- 
tem V) may not be supplied in future releases. 
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Name 

inir - Cleans the file system and executes init. 



Syntax 

/etc/lnir 



Description 

Inir first checks that the console devices (/dev/console, 
/dev/syscon, /dev/systty) are correct, and if not removes 
and creates them. Inir will then fork a child process 
that reports the number of users licensed for this system 
and that cleans the file system by running fsck(C). 

Inir is called as "c" or "d" to indicate whether the file 
system is clean or dirty. If inir is invoked as anything 
other than "c," it assumes the file system is dirty. 

When the child process returns, inir will execute init(M). 



Files 

/dev/console 

/dev/syscon 

/dev/systty 



See Also 

init(M), fsck(C) 
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Name 

init, tellnlt - Process control initialization. 



Sjmtax 

/etc/init [0123456SsQq] 
/etc/ tellnlt [0123456sSQqabc] 



Description 

Init is a general process spawner. Its primary role is to 
create processes from a script stored in the file 
/etc/inittab (see Inittab(M)). This file usually has init 
spawn getty(M) processes on each line that a user may log 
in on. It also controls autonomous processes required by 
any particular system. 

Init considers the system to be in a run-level at any 
given time. A run-level can be viewed as a software con- 
figuration of the system where each configuration allows 
only a selected group of processes to exist. The pro- 
cesses spawned by init for each of these run-levels are 
defined in the inittab file. 

Init can be in one of eight run-levels, 0-6, and S or s. 
The run-level is changed by having a privileged user run 
/etc/telinit (which is linked to /etc/init). This 
user-spawned init sends appropriate signals to the orig- 
inal Inlt spawned by the operating system when the system 
was booted, telling it which run-level to change to. 

Init is invoked as the last step in the boot(M) procedure. 
The first thing it does is to look for /etc/inittab and 
see if there is an entry of the type init default (see 
inittab (M)). If there is, init uses the run-level speci- 
fied in that entry as the initial run-level to enter. If 
this entry is not in inittab or inittab is not found, init 
requests that the user enter a run-level from the virtual 
system console, /dev/syscon. If an S (s) is entered, init 
goes into the SINGLE USER level. This is the only 
run-level that doesn't require the existence of a properly 
formatted inittab file. 
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If /etc/inittab doesn't exist, then by default the only 
legal run-level that init can enter is the SINGLE USER 
level. In the SINGLE USER level, the virtual console ter- 
minal /dev/syscon is opened for reading and writing and 
the command /bin/su is invoked immediately. To exit from 
the SINGLE USER run-level one of two options can be 
elected. First, if the shell is terminated (via an end- 
of-file), init will reprompt for a new run-level. Second, 
the init or telinit command can signal init and force it 
to change the run-level of the system. 

When attempting to boot the system, init may fail to 
prompt for a new run-level because the device /dev/syscon 
is linked to a device other than the physical system ter- 
minal (/dev/systty). If this occurs, init can be forced 
to relink /dev/syscon by typing a delete on the system 
console that is located with the processor. 

When init prompts for the new run-level, you may enter 
only one of the digits 0 through 6 or the letters S or s. 
If S is entered, init operates as previously described in 
SINGLE USER mode with the additional result that 
/dev/syscon is linked to your terminal line, thus making 
it the virtual system console. A message is generated on 
the physical console, /dev/systty, saying where the vir- 
tual terminal has been relocated. 

When init comes up initially and whenever it switches out 
of SINGLE USER state to normal run states, it sets the 
ioctl(S) states of the virtual console, /dev/syscon, to 
those modes saved in the file /etc/ioctl.syscon. This 
file is written by init whenever SINGLE USER mode is 
entered. If this file does not exist when init wants to 
read it, a warning is printed and default settings are 
assumed. 

If a 0 through 6 is entered, init enters the corresponding 
run-level. Any other input will be rejected and the user 
will be reprompted. If this is the first time init has 
entered a run-level other than SINGLE USER, init first 
scans inittab for special entries of the type boot and 
bootwait. These entries are performed, providing the 
run-level entered matches that of the entry before any 
normal processing of inittab. In this way, any special 
initialization of the operating system, such as mounting 
file systems, can take place before users are allowed onto 
the system. The inittab file is scanned to find all en- 
tries that are to be processed for that run-level. 
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Run-level 2 is usually defined by the system administrator 
to contain all of the terminal processes and daemons that 
are spawned in the multiuser environment. Run-level 3 is 
defined to start up remote file sharing processes and 
daemons as well as mount and advertise remote resources. 
So, run-level 3 extends multiuser mode and is known as the 
Remote File Sharing state. 

In a multiuser environment, the inittab file is usually 
set up so that init will create a process for each ter- 
minal on the system. 

For terminal processes, the shell will ultimately termi- 
nate because of an end-of-file either typed explicitly or 
generated as the result of hanging up. When init receives 
a child death signal, telling it that a process it spawned 
has died, it records the fact and the reason it died in 
/etc/utmp and /etc/wtmp if it exists (see who(C)). A his- 
tory of the processes spawned is kept in /etc/wtmp if such 
a file exists. 

To spawn each process in the inittab file, init reads each 
entry and for each entry which should be respawned, it 
forks a child process. After it has spaAvned all of the 
processes specified by the inittab file, init waits for 
one of its descendant processes to die, a powerfail sig- 
nal, or until it is signaled by init or telinit to change 
the system's run-level. When one of the above three con- 
ditions occurs, init re-examines the inittab file. New 
entries can be added to the inittab file at any time. To 
provide for an instantaneous response the telinit Q or 
telinit q command can wake init to reexamine the inittab 
file. 

If init receives a powerfail signal (SIGWPR) and is not 
in SINGLE USER mode, it scans inittab for special 
powerfail entries. These entries are invoked (if the 
run-levels permit) before any further processing takes 
place. In this way init can perform various cleanup and 
recording functions whenever the operating system experi- 
ences a power failure. Note that in the single-user 
state, only powerfail and powerwait entries are executed. 

When init is requested to change run-levels (via telinit), 
it sends the warning signal (SIGTERM) to all processes 
that are undefined in the target run-level. Init waits 20 
seconds before forcibly terminating these processes via 
the kill signal (SIGKILL). 
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Telinit 

Telinit, which is linked to /etc/init, is used to direct 
the actions of init(S). It takes a one-character argument 
and signals init via the kill system call to perform the 
appropriate action. You must be the super-user to run 
telinit. 

The following arguments serve as directives to init. 

0-6 Tells init to place the system in one of the 

run-levels 0-6. Run level 0 is used for shut- 
down; 1 is single user mode; and 2 is multiuser 
mode. To switch between single and multiuser 
modes, use the scripts /etc/singleuser and 
/etc/multiuser. 

a,b,e Tells init to process only those /etc/inittab 

file entries having the a, b, or c run-level set 
(see inittab(M)). 

q,Q Tells init to re-examine the /etc/inittab file. 

s,S Tells init to enter the single user environment. 

The virtual system teletype, /dev/syscon, is 
changed to the terminal from which the command 
was executed. 



Init.d 

The /etc/init. d directory contains initialization and ter- 
mination scripts for changing init states. These scripts 
are linked with appropriate files in the rc?.d direc- 
tories. 

File names in rc?.d directories are of the form 
[S |K]nn<init.d filename> where S means start this job, K 
means kill this job, and nn is the relative sequence num- 
ber for killing or starting the job. When entering a 
state (init 0, 2, 3, etc.), the rc[0-6] script executes 
those scripts in /etc/rc[0-6].d that are prefixed with K 
followed by those scripts prefixed with S. 

For example, when changing to init state 2 (default 
multi-user mode), /etc/rc2 is initiated by the init pro- 
cess. The following steps are performed by /etc/rc2: 
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In the directory /etc/rc2.d are files used to stop 
processes that should not be running in state 2. The 
file names are prefixed with K. Each K file in the 
directory is executed (by /etc/rc2) in alpha-numeric 
order when the system enters init state 2 (see the 
following example). 

The rc2.d directory also contains files used to start 
processes that should be running in state 2. As in 
the step above, each S file is executed. 

Example: 

The file /etc/netdaemon contains a script that ini- 
tiates networking daemons when given the argument 
start and terminates the daemons if given the argu- 
ment stop. It is linked to /etc/rc2.d/S68netdaemon, 
and to /etc/rc0.d/K67netdaemon. 

This script is executed by /etc/rc2.d/S68netdaemon 
start when init state 2 is entered and by 
/etc/rc0.d/S67netdaemon stop when shutting the sys- 
tem down. 



Files 

/etc/inittab 

/etc/init.d 

/etc/rcO 

/etc/rcO.d 

/etc/rc2 

/etc/rc2.d 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/dev/syscon 



See Also 

brc(M), getty(M), inittab(M), login(C), rcO(M), rc2(M), 
sh(C), utmp(M), who(C) 
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Diagnostics 

If init finds that it is continuously respawning an entry 
from /etc/inittab more than 10 times in 2 minutes, it as- 
sumes there is an error in the command string, generates 
an error message on the system console, and refuses to 
respawn this entry until either 1 minute has elapsed or it 
receives a signal from a user init (telinit). This pre- 
vents init from eating up system resources when someone 
makes a typographical error in the inittab file or a pro- 
gram is removed that is referenced in the inittab. 



Notes 

Telinit can be run only by someone who is the super-user 
or a member of group sys. Attempting to relink 
/dev/console with /dev/contty by typing ■■laa on the sys- 
tem console does not work. 
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Name 

inittab - Script for the init process. 



Description 

The /etc/inittab file supplies the script to init(M)'s 
role as a general process dispatcher. The process that 
constitutes the majority of init's process dispatching 
activities is the line process getty(M) that initiates 
individual terminal lines. Other processes typically dis- 
patched by init are daemons and the shell. 

The inittab file is composed of entries that are position 
dependent and have the following format: 

id:rstate:action:process 

Each entry is delimited by a newline; however, a backslash 
(\) preceding a newline indicates a continuation of the 
entry. Up to 512 characters per entry are permitted. 
Comments may be inserted in the process field using the 
sh(C) convention for comments. Comments for lines that 
spawn getty(M) are displayed by the who(C) command. 
They tj^pically contain some information about the line 
such as the location. There are no limits (other than 
maximum entry size) imposed on the number of entries 
within the inittab file. The entry fields are: 

id This is one or two characters used to uniquely 

identify an entry. 

rstate This defines the run-level in which this entry 
is to be processed. Run-levels effectively cor- 
respond to a configuration of processes in the 
system. That is, each process spawned by init 
is assigned a run-level (or run-levels) in which 
it is allowed to exist. The run-levels are rep- 
resented by a number ranging from 0 through 6. 
As an example, if the system is in run-level 1, 
only those entries having a 1 in the rstate 
field will be processed. When init is requested 
to change run-levels, all processes that do not 
have an entry in the rstate field for the target 
run-level will be sent the warning signal 
(SIGTERM) and allowed a 20-second grace perioc 
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before being forcibly terminated by a kill sig- 
nal (SIGKILL). The rstate field can define mul- 
tiple run-levels for a process by selecting more 
than one run-level in any combination from 0-6. 
If no run-level is specified, then the process 
is assumed to be valid at all run-levels 0-6. 
There are are three other values, a, b, or c, 
which can appear in the rstate field, even 
though they are not true run-levels. Entries 
that have these characters in the rstate field 
are processed only when the telinit (see 
init(M)) process requests them to be run 
(regardless of the current run-level of the 
system). They differ from run-levels in that 
init can never enter run-level a, b, or c. 
Also, a request for the execution of any of 
these processes does not change the current 
run-level. Furthermore, a process started by a, 
b, or c command is not killed when init changes 
levels. They are only killed if their line in 
/etc/inittab is marked off in the action field, 
their line is deleted entirely from 
/etc/inittab, or init goes into the SINGLE USER 
state. 

action Key words in this field tell init how to treat 

the process specified in the process field. The 
actions recognized by init are as follows: 

respawn If the process does not exist then 

start the process, do not wait for its 
termination (continue scanning the 
inittab file), and when it dies re- 
start the process. If the process 
currently exists then do nothing and 
continue scanning the inittab file. 

wait Upon init's entering the run-level 

that matches the entry's rstate^ start 
the process and wait for its termina- 
tion. All subsequent reads of the 
inittab file while init is in the same 
run-level will cause init to ignore 
this entry. 
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once Upon init's entering a run-level that 

matches the entry's rstate, start the 
process, do not wait for its termina- 
tion. When it dies, do not restart 
the process. If upon entering a new 
run-level, where the process is still 
running from a previous run-level 
change, the program will not be re- 
started. 

boot The entry is to be processed only at 

init's boot-time read of the inittab 
file. Init is to start the process, 
not wait for its termination; and when 
it dies, not restart the process. In 
order for this instruction to be mean- 
ingful, the rstate should be the de- 
fault or it must match init's 
run-level at boot time. This action 
is useful for an initialization func- 
tion following a hardware reboot of 
the system. 

bootwait The entry is to be processed only at 
init's boot-time read of the inittab 
file. Init is to start the process, 
wait for its termination, and, when it 
dies, not restart the process. 

powerfail Execute the process associated with 
this entry only when init receives the 
power fail signal (SIGPWR, see 
signal(S)), which normally occurs wher 
a UPS detects a power failure. 

powerwait Execute the process associated with 
this entry only when init receives the 
power fail signal (SIGPWR) and wait 
until it terminates before continuing 
any processing of inittab. 

off If the process associated with this 

entry is currently running, send the 
warning signal (SIGTERM) and wait 2( 
seconds before forcibly terminating 
the process via the kill signal 
(SIGKILL). If the process is nonexis- 
tent, ignore the entry. 
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ondemand This instruction is really a synonym 
for the respawn action. It is func- 
tionally identical to respawn but is 
given a different kejrword in order to 
divorce its association with run- 
levels. This is used only with the a, 
b, or c values described in the rstate 
field. 



initdefault 

An entry with this action is only 
scanned when init initially invoked. 
Init uses this entry, if it exists, to 
determine which run-level to enter 
initially. It does this by taking the 
highest run-level specified in the 
rstate field and using that as its 
initial state. If the rstate field is 
empty, this is interpreted as 0123456 
and so init will enter run-level 6. 
Also, the initdefault entry cannot 
specify that init start in the SINGLE 
USER state. Additionally, if init 
does not find an initdefault entry in 
/etc/inittab, then it will request an 
initial run-level from the user at 
reboot time. 



restart Entries of this type are executed on a 
warm restart of the system after a 
power failure. 



sysinit Entries of this type are executed be- 
fore init tries to access the console. 
It is expected that this entry will be 
only used to initialize devices on 
which init might try to ask the 
run-level question. These entries are 
executed and waited for before con- 
tinuing. 

process This is a sh(C) command to be executed. The 
entire process field is prefixed with exec and 
passed to a forked sh as sh -c exec command. 
For this reason, any legal sh syntax can appear 
in the process field. Comments can be inserted 
with the ; ^comment syntax. 
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/etc/inittab 

See Also 

getty(M), init(M), sh(C), who(C) 
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Name 

in ode - Format of an inode. 

Syntax 

^include <sys/ types. h> 
#include <sys/ino.h> 

Description 

An inode for a plain file or directory in a file system 
has the structure defined by <sys/ino.h>. For the meaning 
of the defined types off_t and time t, see types(F). 

Files 

/usr/include/sys/ino.h 
See Also 

filesystem(M) and stat(S), types(F) in the Reference (CP, 
S, F) 
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Name 

install - Installs commands. 



Syntax 

/etc/install [-c dira] [-f dirb] [-1] [-n dire] [-m mode] 
[-U user] [-g group] [-o] [-s] file [dirx...] 



Description 

The install command is most commonly used in "makefiles" 
(see make(C)) to install a file (updated target file) in a 
specific place within a file system). Each file is in- 
stalled by copying it into the appropriate directory, 
thereby retaining the mode and owner of the original com- 
mand. The program prints messages telling the user exact- 
ly what files it is replacing or creating and where they 
are going. 

If no options or directories {dirx ...) are given, install 
will search a set of default directories (/bin, /usr/bin, 
/etc, /lib, and /usr/ lib, in that order) for a file with 
the same name as file. When the first occurrence is 
found, install issues a message saying that it is over- 
writing that file with file, and proceeds to do so. If 
the file is not found, the program states this and exits 
without further action. 

If one or more directories {dirx ...) are specified after 
file, those directories will be searched before the direc- 
tories specified in the default list. 

The meanings of the options are: 

-c dira Installs a new command {file) in the directory 
specified by dira, only if it is not found. If 
it is found, install issues a message saying 
that the file already exists, and exits without 
overwriting it. May be used alone or with the 
-s option. 
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-f dirb Forces file to be installed in given directory, 
whether or not one already exists. If the file 
being installed does not already exist, the mode 
and owner of the new file will be set to 755 and 
bin, respectively. If the file already exists, 
the mode and owner will be that of the already 
existing file. May be used alone or with the -o 
or -s options. 

-i Ignores default directory list, searching only 

through the given directories (dirx ...). May 
be used alone or with any other options except 
-c and -f. 



-n dire If file is not found in any of the searched 
directories, it is put in the directory speci- 
fied in dire. The mode and owner of the new 
file will be set to 755 and bin, respectively. 
May be used alone or with any other options ex- 
cept -c and -f. 

-m mode The mode of the new file is set to mode. Only 
available to the super-user. 

-u user The owner of the new file is set to user. Only 
available to the super-user. 

-g group The group id of the new file is set to group. 
Only available to the super-user. 



-o 



If file is found, this option saves the "found" 
file by copying it to OLDfile in the directory 
in which it was found. This option is useful 
when installing a frequently used file such as 
/bin/sh or /etc/getty, where the existing file 
cannot be removed. May be used alone or with 
any other options except -c. 

Suppresses printing of messages other than error 
messages. May be used alone or with any other 
options. 



See Also 

make(C) 
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Name 



keyboard - Series 500 system console keyboard. 



Description 



The system console (and user's terminal) is composed of 
two separate pieces: the keyboard and the display (see 
display(M)). Because of their complexity they are dis- 
cussed in separate manual entries. 

The actual code sequence delivered to the terminal input 
routine (see termio(M)) is defined by a set of internal 
tables in the driver. These tables can be modified by 
software (see ioctl calls below). In addition, the 
driver can be instructed not to do translations, deliver- 
ing the keyboard up/down scan codes directly. 

There are four translation tables: normal keys, shifted 
keys, alt keys, and shifted alt keys. Each table contains 
128 16-bit entries, with an entry being made up of flags 
in the high-order 8 bits and the character code in the 
low-order 8 bits. The values that can be set in the flag 
byte, as defined in <sys/kd.h>, are as follows: 



/* Flag bits */ 

#define NUMLCK 0x8000 /* 

#define CAPLCK 0x4000 /* 

#define CTLKEY 0x2000 /* 



key is affected by num lock */ 
key is affected by caps lock */ 
key is affected by control key */ 



/* Key types */ 



#define 


NORMKEY 


0x0000 


/* 


key is a normal key */ 




#def ine 


SHIFTKEY 


0x0100 


/* 


key is a shift key */ 




#def ine 


BREAKKEY 


0x0200 


/* 


key is a break key */ 




#def ine 


SS2PFX 


0x0300 


/* 


prefix key with <ESC> N 


*/ 


#def ine 


SS3PFX 


0x0400 


/* 


prefix key with <ESC> 0 


*/ 


#def ine 


CSIPFX 


0x0500 


/* 


prefix key with <ESC> [ 


*/ 


#def ine 


NOKEY 


OxOfOO 


/* 


key sends nothing */ 





The tables are indexed by the keyboard scan code received. 
The table that is used is determined by the state of the 
following special keys: 
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ALT This key essentially chooses an alternate key- 

board. If it is not depressed, the normal and 
shifted tables are used; if it is depressed, the 
alt and shifted alt tables are used. 

SHIFT Depending on the ALT key, this key shifts into 
either the shifted table or the shifted alt 
table. The default shifted table is set up such 
that SHIFT will generate the ASCII uppercase 
characters. 

The character code found in the table may be further modi- 
fied by the following keys: 

CTRL Produces the appropriate ASCII control character 
if the CTLKEY bit is set in the flag byte. The 
control character is produced by masking off all 
but the low-order 5 bits of the character code 
in the table. If the CTLKEY bit is not set, the 
normal character (the code in the table) is gen- 
erated. In the default tables, the CTRL key 
only modifies keys in the normal and shifted 
tables; it has no effect in the alt or shifted 
alt tables. 

CAPS LOCK 

This is a toggle; it controls whether keys that 
have the CAPLCK bit set in their flag byte go to 
the normal or shifted table. If the CAPLCK bit 
is not set, the normal character is generated 
regardless of the state of the CAPS LOCK. The 
SHIFT key inverts whatever state is indicated by 
the CAPS LOCK. Thus, if CAPS LOCK is off, 
SHIFT produces uppercase characters; if CAPS 
LOCK is on, SHIFT produces lowercase characters. 
In the default tables, the only keys affected by 
CAPS LOCK are the alphabetic keys. 

NUM LOCK 

This is a toggle; it controls whether keys that 
have the NUMLCK bit set in their flag byte go 
to the normal or shifted table. If the NUMLCK 
bit is not set, the normal character is gener- 
ated regardless of the state of the NUM LOCK. 
The SHIFT key inverts whatever state is indi- 
cated by the NUM LOCK. In the default tables, 
the only keys affected by NUM LOCK are the 



2 



KEYBOARD(M) 



KEYBOARD(M) 



keypad keys. Note that CAPS LOCK and NUM 
LOCK do exactly the same thing; the only dif- 
ference is the set of keys affected. 

SCROLL LOCK 

This key is marked as a BREAKKEY in its flag 
byte in both the shifted and shifted alt tables. 
This causes it to send BREAK to the terminal 
handler. 

The remaining values for the key type are discussed below: 
SHIFTKEY 

This is used to mark the left and right SHIFT 
keys, the CTRL key, the ALT key, the CAPS 
LOCK, and the NUM LOCK in the translation 
tables. User programs will normally not be con- 
cerned with this flag. 

SS2PFX, SS3PFX, CSIPFX 

These are used to generate codes for the func- 
tion keys and for the ALT keys. If one of these 
flags is specified in the translation table, the 
driver will prefix the character code in the 
table with <ESC>N, <ESC>0, or <ESC>[ respec- 
tively, where <ESC> represents the ASCII escape 
character (lb hex). 

NOKEY This is used to mark entries that should not 

generate any character code. Keystroke combina- 
tions that index table entries marked with this 
flag generate nothing. 

The following tables describe the codes generated by the 
default tables for all the keys. Keycodes are the values 
delivered at the keyboard interface when the corresponding 
key is struck (the down scan code). Note that when the 
key is released, the same code is delivered, but with the 
high-order bit set. Thus, codes 01 -7f are down codes, and 
81-ff are up codes. The generated codes are the codes 
delivered to the terminal driver after translation. All 
numbers are in hexadecimal. 
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Shifting Keys 



Key Code Function 



Ctrl 


Id 


CTRL 


Left Shift 


2a 


SHIFT 


Right Shift 


36 


SHIFT 


Alt 


38 


ALT 


Caps Lock 


3a 


CAPS LOCK 


Num Lock 


45 


NUM LOCK 



Special Keys 



Keyboard Generated Codes SHIFT 

Key Code Normal SHIFT CTRL ALT ALT 



BACKSPACE 


Oe 


08 


bs 


08 


bs 


08 


bs 


08 


bs 


08 


bs 


TAB 


Of 


09 


ht 


Id 


gs 


09 


ht 


09 


ht 


Id 


gs 


RETURN 


Ic 


Od 


cr 


Od 


cr 


Od 


cr 


Od 


cr 


Od 


cr 


SPACE 


39 


20 


sp 


20 


sp 


00 


nul 


20 


sp 


20 


sp 


ESC 


01 


lb 


esc 


lb 


esc 


lb 


esc 


lb 


esc 


lb 


esc 
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Alphabetic Keys 



Keyboard Generated Codes SHIFT 

Key Code Normal SHIFT CTRL ALT ALT 



a 


le 


61 


a 


41 


A 


01 


soh 


Ib4e61 


Ib4e41 


b 


30 


62 


b 


42 


B 


02 


stx 


Ib4e62 


Ib4e42 


c 


2e 


63 


c 


43 


C 


03 


etx 


Ib4e63 


Ib4e43 


d 


20 


64 


d 


44 


D 


04 


eot 


Ib4e64 


Ib4e44 


e 


12 


65 


e 


45 


E 


05 


enq 


Ib4e65 


Ib4e45 


f 


21 


66 


f 


46 


F 


06 


ack 


Ib4e66 


Ib4e46 


g 


22 


67 


g 


47 


G 


07 


bel 


Ib4e67 


Ib4e47 


h 


23 


68 


h 


48 


H 


08 


bs 


Ib4e68 


Ib4e48 


i 


17 


69 


i 


49 


I 


09 


ht 


Ib4e69 


Ib4e49 


j 


24 


6a 


j 


4a 


J 


Oa 


If 


Ib4e6a 


Ib4e4a 


k 


25 


6b 


k 


4b 


K 


Ob 


vt 


Ib4e6b 


Ib4e4b 


1 


26 


6c 


1 


4c 


L 


Oc 


f f 


Ib4e6c 


Ib4e4c 


m 


32 


6d 


m 


4d 


M 


Od 


cr 


Ib4e6d 


Ib4e4d 


n 


31 


6e 


n 


4e 


N 


Oe 


so 


Ib4e6e 


Ib4e4e 


o 


18 


6f 


o 


4f 


0 


Of 


si 


Ib4e6f 


Ib4e4f 


P 


19 


70 


P 


50 


P 


10 


die 


Ib4e70 


Ib4e50 


q 


10 


71 


q 


51 


Q 


11 


del 


Ib4e71 


Ib4e51 


r 


13 


72 


r 


52 


R 


12 


dc2 


Ib4e72 


Ib4e52 


s 


If 


73 


s 


53 


S 


13 


dc3 


Ib4e73 


Ib4e53 


t 


14 


74 


t 


54 


T 


14 


dc4 


Ib4e74 


Ib4e54 


u 


16 


75 


u 


55 


U 


15 


nak 


Ib4e75 


Ib4e55 


V 


2f 


76 


V 


56 


V 


16 


syn 


Ib4e76 


Ib4e56 


w 


11 


77 


w 


57 


W 


17 


etb 


Ib4e77 


Ib4e57 


X 


2d 


78 


X 


58 


X 


18 


can 


Ib4e78 


Ib4e58 


y 


15 


79 


y 


59 


Y 


19 


em 


Ib4e79 


Ib4e59 


z 


2c 


7a 


z 


5a 


Z 


la 


sub 


Ib4e7a 


Ib4e5a 



5 



KEYBOARD(M) 



KEYBOARD(M) 



Numeric and Punctuation Keys 



Keyboard Generated Codes SHIFT 

Key Code Normal SHIFT CTRL ALT ALT 



1 


02 


31 


1 


21 


I 


31 


1 


Ib4e31 


Ib4e21 


2 


03 


32 


2 


40 


@ 


00 


nul 


Ib4e32 


Ib4e40 


3 


04 


33 


3 


23 


# 


33 


3 


Ib4e33 


Ib4e23 


4 


05 


34 


4 


24 


$ 


34 


4 


Ib4e34 


Ib4e24 


5 


06 


35 


5 


25 


% 


35 


5 


Ib4e35 


Ib4e25 


6 


07 


36 


6 


5e 


- 


le 


rs 


Ib4e36 


Ib4e5e 


7 


08 


37 


7 


26 




37 


7 


Ib4e37 


Ib4e26 


8 


09 


38 


8 


2a 


* 


38 


8 


Ib4e38 


Ib4e2a 


9 


Oa 


39 


9 


28 


( 


39 


9 


Ib4e39 


Ib4e28 


0 


Ob 


30 


0 


29 


) 


30 


0 


Ib4e30 


Ib4e29 




Oc 


2d 




5f 




If 


us 


Ib4e2d 


Ib4e5f 




Od 


3d 




2b 


+ 


3d 




Ib4e3d 


Ib4e2b 


[ 


la 


5b 


[ 


7b 


{ 


lb 


esc 


Ib4e5b 


Ib4e7b 


] 


lb 


5d 


] 


7d 


} 


Id 


gs 


Ib4e5d 


Ib4e7d 




27 


3b 




3a 




3b 




Ib4e3b 


Ib4e3a 




28 


27 




22 




27 




Ib4e27 


Ib4e22 




29 


60 




7e 




le 


rs 


Ib4e60 


Ib4e7e 


\ 


2b 


5c 


\ 


7c 


1 


Ic 


fs 


Ib4e5c 


Ib4e7c 




33 


2c 




3c 


< 


2c 




Ib4e2c 


Ib4e3c 




34 


2e 




3e 


> 


2e 




Ib4e2e 


Ib4e3e 


/ 


35 


2f 


/ 


3f 


•> 


If 


us 


Ib4e2f 


Ib4e3f 
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Keypad Keys 



Keyboard Generated Codes SHIFT 

Key Code Normal SHIFT CTRL ALT ALT 



* 


37 


2a * 


2a 


* 


2a * 


Ib4e2a 


Ib4e2a 


scroll lock 


46 


Ib5b4d 


CO 


break 


Ib5b4d 


Ib5b4d 


00 break 


home 


47 


Ib5b48 


37 


7 


Ib5b48 


Ib5b48 


Ib4e37 


up arrow 


48 


Ib5b41 


38 


8 


Ib5b41 


Ib5b41 


Ib4e38 


page up 


49 


Ib5b49 


39 


9 


Ib5b49 


Ib5b49 


Ib4e39 


minus 


4a 


2d - 


2d 




2d - 


Ib4e2d 


Ib4e2d 


left arrow 


4b 


Ib5b44 


34 


4 


Ib5b44 


Ib5b44 


Ib4e34 


5 


4c 


Ib5b4 5 


35 


5 


Ib5b45 


Ib5b45 


Ib4e35 


right arrow 


4d 


Ib5b43 


36 


6 


Ib5b43 


Ib5b43 


Ib4e36 


plus 


4e 


2b + 


2b 




2b + 


Ib4e2b 


Ib4e2b 


end 


4f 


Ib5b46 


31 


1 


Ib5b46 


Ib5b46 


Ib4e31 


down arrow 


50 


Ib5b42 


32 


2 


Ib5b42 


Ib5b42 


Ib4e32 


page down 


51 


Ib5b47 


33 


3 


Ib5b47 


Ib5b47 


Ib4e33 


insert 


52 


Ib5b4c 


30 


0 


Ib5b4c 


Ib5b4c 


Ib4e30 


del 


53 


7f 


2e 




7f 


7f 


Ib4e2e 


sys req 


54 


00 


00 




00 


00 


Ib5b35 



Function Keys 



Keyboard Generated Codes SHIFT 

Key Code Normal SHIFT CTRL ALT ALT 



Fl 


3b 


Ib5b4d 


Ib5b59 


Ib5b6b 


Ib4e4d 


Ib4e59 


F2 


3c 


Ib5b4e 


Ib5b5a 


Ib5b6c 


Ib4e4e 


Ib4e5a 


F3 


3d 


Ib5b4f 


Ib5b61 


Ib5b6d 


Ib4e4f 


Ib4e61 


F4 


3e 


Ib5b50 


Ib5b62 


Ib5b6e 


Ib4e50 


Ib4e62 


F5 


3f 


Ib5b51 


Ib5b63 


Ib5b6f 


Ib4e51 


Ib4e63 


F6 


40 


Ib5b52 


Ib5b64 


Ib5b70 


Ib4e52 


Ib4e64 


F7 


41 


Ib5b53 


Ib5b65 


Ib5b71 


Ib4e53 


Ib4e65 


F8 


42 


Ib5b54 


Ib5b66 


Ib5b72 


Ib4e54 


Ib4e66 


F9 


43 


Ib5b55 


Ib5b67 


Ib5b73 


Ib4e55 


Ib4e67 


FIO 


44 


Ib5b56 


Ib5b68 


Ib5b74 


Ib4e56 


Ib4e68 


Fll 


57 


Ib5b57 


Ib5b69 


Ib5b75 


Ib4e57 


Ib4e69 


F12 


58 


Ib5b58 


Ib5b6a 


Ib5b76 


Ib4e58 


Ib4e6a 



7 



KEYBOARD(M) 



KEYBOARD(M) 



Foreign Character Set Support 

The keyboard driver supports input and output mapping for 
9 different foreign language keyboards and character sets. 
The foreign keyboards supported are: 



Language Type 

Language defined in <sys/kd.h> Function key 



English 


US_ENGLISH 


Fl 


U.K. /British 


UK_ENGLISH 


F2 


French 


FRENCH 


F3 


German 


GERMAN 


F4 


Spanish 


SPANISH 


F5 


Swedish 


SWEDISH 


F6 


Norwegian 


NORWEGIAN 


F7 


Danish 


DANISH 


F8 


Italian 


ITALIAN 


F9 


7/8 Bit Mode 




FIO 


Toggle 







The Series 500 Owner's Guide describes the keyboard lay- 
outs and ASCII character sets for each keyboard. 

There are 3 ways to change from one language mapping to 
another. They are: 

1. TOngLUflSPBRHTB key combination 

2. /etc/language file 

3. KDSETLANG and KDGETLANG ioctl commands 

At any time when the operating s ystem i s runn ing, the user 
can simultaneously type the keys TOW , waim and BSBS^W 
followed by a Function key, to change keyboard mapping. 
The function keys for each language are listed in the 
table above. To change to U.K . English, for ex ample, the 
user wou ld simultaneously press KWHiTOHiBSBSrSl then type 
the mam key. The current language will stay in effect un- 
til it is changed via a key sequence, an ioctl call, or 
until the system is rebooted. Note, on some keyboards, 
the SYSREQ key is labeled as PRINT SCREEN. 
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The BailM key is used to toggle between 7-bit and 8-bit 
versions of the language type currently in use. When the 
system is first booted, 7-bit character sets are used by 
default. The Maiia key does not change the language type. 

The system can be configured to boot with a particular 
language other than English as the default. This is done 
via the /etc/language file. If this file is present and 
contains a string matching one of the valid language types 
from the table above, then that language is mapped in im- 
mediately. If the file is not present or does not contain 
a valid language type, then the default language 
(US_ENGLISH) is used. 

For an explanation of KDSETLANG and KDGETLANG, see 
the ioctl section that follows. 



loctl Calls 

KDGKBTYPE 

This call is used to get the current keyboard type. 
It places one of the following numbers, as defined in 
<sys/kd.h>, at the unsigned char pointed to by the 
ioctl argument: 

#define KB_84 1 /* 84-keY keyboard */ 

idefine KB_101 2 /* 101/102-key keyboard */ 

#define KB_OTHER 3 /* other type of keyboard */ 

KDGKBMODE 

This call is used to get the current keyboard mode. 
It returns one of the following numbers, as defined 
in <sys/kd.h>: 

#define K_RAW 0x00 /* send up/down scan codes */ 
#define K_XLATE 0x01 /* translate to ascii */ 

KDSKBMODE 

This call is used to set the keyboard mode. The 
argument to the ioctl is either K_RAW or K_XLATE. 
By using raw mode, the program can see the raw 
up/down can codes from the keyboard. In translate 
mode, the translation tables are used to generate the 
appropriate character code. 
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KDGKBENT 

This call is used to read one of entries in the 
translation tables. The argument to the ioctl is the 
address of one of the following structures, defined 
in <sys/kd.h>, with the first two fields filled in: 



struct kbentry { 

unchar kb_table; 
unchar kb_index; 
ushort kb_value; 

) 

/* Table selectors */ 
#define K_NORMTAB 
#define K_SHIFTTAB 
#define K_ALTTAB 
#define K ALTSHIFTTAB 



/* which table to use */ 
/* which entry in table */ 
/* value to get/set */ 



0x00 /* normal table */ 

0x01 /* shifted table */ 

0x02 /* alt table */ 

0x03 /* shifted alt table */ 



The ioctl will get the indicated entry from the indi- 
cated table and return it in the third field. 



KDSKBENT 

This call is used to set an entry in one of the 
translation tables. It uses the same structure as 
the KDGKBENT ioctl, but with the third field filled 
in with the value that should be placed in the trans- 
lation table. This can be used to partially or com- 
pletely remap the keyboard. 

KDGETLED 

Used to return an unsigned character which may have 
any or none of the following flags (defined in 
<sys/kd.h>) set: 

LED_CAP The CAP LOCK key is set 

LED_SCR The SCROLL LOCK key is set 

LED_NUM The NUM LOCK key is set 

KDSETLED 

Used to set the CAP LOCK, SCROLL LOCK, or NUM 
LOCK keys. The argument should contain one or all 
of the valid flags shown under KDGETLED. 
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KDMKTONE 

Used to ring the bell at given frequency and for a 
given duration. The argument is a long integer hav- 
ing the following format: 



The frequency used for the normal system bell charac- 
ter is 1331 (decimal). 

KDGETLANG 

Used to return the current language in use on the 
console terminal. The argument returned is an inte- 
ger which contains one of the valid language types 
(defined in <sys/kd.h>) listed previously under For- 
eign Character Set Support. 

KDSETLANG 

Used to change the language in use on the console 
terminal. Uses an integer argument which should be 
set to one of the valid language types (defined in 
<sys/kd.h>). The change takes effect immediately. 

If the argument is 7-bit or 8-bit (defined in 
<sys/kd.h>), the terminal switches to a 7 or 8-bit 
version of the language currently in use. 



lower 16 bits 
upper 16 bits 



Contains desired frequency 
Time to ring in milliseconds 



Files 



/dev/console 



See Also 



ioctl(S), display(M), termio(M), vt(M) 
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Name 

killall - Kills all active processes. 

Syntax 

/etc/killall [signal] 

Description 

Killall terminates all active processes not directly re- 
lated to the shutdown procedure. KUlall is used by 
/etc/shutdown, and can only be run by the super-user. 

Killall terminates all processes with open files so that 
the mounted file systems will be unbusied and can be un- 
mounted. 

Killall sends signal (see kill(C)). The default signal 
is 9. 

Files 

/etc/shutdown 

See Also 

kill(C), ps(C), shutdown(M) 
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Name 

layout - Manages hard disk partitions. 



Syntax 

/etc/layout -c | -p driveid 

/etc/layout -la |b|c|d|elf|g|h|. spares]. restart driveid 
/etc/layout [-f] [-r m|c] [-d] | [-e] | [-m] driveid 
Idevice 



Description 

The layout command is used to create, alter, and inspect 
the partition map on a hard disk unit. The hard disk par- 
tition map is a fixed-size table of 16 entries, each of 
which describes the position and size of a logical device 
on a hard disk. This information, along with the bad- 
sector map (/dev/hd?.secmap), is used by the file pro- 
cessor subsystem. 



CAUTION 

Only an experienced system administrator 
should use this command. Running layout 
could make all of your fUes inaccessible. 



Several of these devices are informational and have fixed 
locations (track 0, cylinder 0). Other logical devices 
are made available for definition by the user. 
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The logical devices are: 



Offset Device 



0 


hdO 


1 


hdOa 


2 


hdOb 


3 


hdOc 


4 


hdOd 


5 


hdOe 


6 


ndOr 


7 


naUg 


8 


hdOh 


9 


hdO. spares 


10 


hdO.drinfo 


11 


hdO.badlist 


12 


hdO.boot 


13 


hdO. restart 


14 


hdO. layout 


15 


hdO.secmap 



LAYOUT(hJ. 



Use 



unmapped drive 

user defined - default swap area 

on drive 0 
user defined - root file system oi 

drive 0 
user defined 
user defined 
user defined 
user defined 
user defined 
user defined 

alternates for unmapped bad 
sectors 

drive configuration information 
(recorded during manufacturing) 

list of bad sectors (recorded 
during manufacturing) 

boot program 

restart partition 

layout information 

sector sparing map 



The second hard disk (hdl) starts at 16 and the third hard 
disk (hd2) starts at 48. 



Layout for the Series 500 
UNIX - hdO 

For the Series 500, if you partition the disk with more 
than one partition, the driveid is a two-digit number. 
The first digit is the physical disk number (0 or 1). The 
second digit is the partition number (0, 1, 2, or 3). 
For example, if you partition your hard disk for both 
UNIX and DOS, the partitions are hdO and hdOl, 
respectively. 
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The following lists show the minor device number for the 
partitions and logical devices on the Series 500 hard 
disks. The major device number for all of these logical 
devices is 0. When UNIX is installed, minor devices 0 - 
15 are automatically made. If a second hard disk is in- 
stalled, only minor devices 16-31 are made for it. 

If you want more than one UNIX partition, run fdisk(C) 
to split up the hard disk. Then run mknod(C) to create 
the logical devices for it. For example, run the follow- 
ing 16 commands to make the devices for the second parti- 
tion (i.e., partition 1) on drive 0; 



/etc/mknod /dev/hdOl c 0 32 
/etc/mknod /dev/hdOla c Q 33 
/etc/mknod /dev/hdOlb c 0 34 
/etc/mknod /dev/hdOlc c 0 35 
/etc/mknod /dev/hdOld c 0 36 
/etc/mknod /dev/hdOle c 0 37 
/etc/mknod /dev/hdOlf c 0 38 
/etc/mknod /dev/hdOl . f sck c 0 39 
/etc/mknod /dev/hdOlh c 0 40 
/etc/mknod /dev/hdOl . spares q 0 41 
/etc/mknod /dev/hdOX . driof o c 0 42 
/etc/mknod /dev/hdOl . badlist q 0 43 
/etc/mknod /dev/hdOl . boot c 0 44 
/etc/mknod /dev/hdOl . restart c 0 45 
/etc/mknod /dev/hdOl . layout c 0 46 
/etc/mknod /dev/hdOl . secmap c 0 47 



Minor device numbers (offset) for the partitions and log- 
ical devices are listed in the following pages. 
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Drive 0, Partition 0 



Offset 


Device 


0 


hdO (or hdOO) 


1 


hdOa (or hdOOa) 


2 


hdOb (or hdOOb) 


3 


hdOc (or hdOOc) 


4 


hdOd (or hdOOd) 


5 


hdOe (or hdOOe) 


6 


hdOf (or hdOOf) 


7 


hdO.fsck (or hdOO.fsck) 


8 


hdOh (or hdOOh) 


9 


hdO. spares (or hdOO. spares) 


10 


hdO.drinfo (or hdOO.drinfo) 


11 


hdO.badlist (or hdOO.badlist) 


12 


hdO.boot (or hdOO.boot) 


13 


hdO. restart (or hdOO. restart) 


14 


hdO. layout (or hdOO. layout) 


15 


hdO.secmap (or hdOO.secmap) 



Drive 1, Partition 0 



Offset 


Device 


16 


hdl (or hdlO) 


17 


hdla (or hdlOa) 


18 


hdlb (or hdlOb) 


19 


hdlc (or hdlOc) 


20 


hdld (or hdlOd) 


21 


hdle (or hdlOe) 


22 


hdlf (or hdl Of) 


23 


hdl.fsck (or hdlO.fsck) 


24 


hdlh (or hdlOh) 


25 


hdl. spares (or hdlO. spares) 
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Drive 1, Partition 0 (Cont.) 



Offset 


Device 


26 


hdl.drinfo (or hdlO.drinfo) 


27 


hdl.badlist (or hdlO.badlist) 


28 


hdl.boot (or hdlO.boot) 


29 


hdl. restart (or hdlO. restart) 


30 


hdl. layout (or hdlO. layout) 


31 


hdl.secmap (or hdlO.secmap) 



Drive 0, Partition 1 



Offset 


Device 


32 


hdOl 


33 


hdOla 


34 


hdOlb 


35 


hdOlc 


36 


hdOld 


37 


hdOle 


38 


hdOlf 


39 


hdOl.fsck 


40 


hdOlh 


41 


hdOl. spares 


42 


hdOl.drinfo 


43 


hdOl.badlist 


44 


hdOl.boot 


45 


hdOl. restart 


46 


hdOl. layout 


47 


hdOl.secmap 
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Drive 1, Partition 1 



Offset 


Device 


48 


hdll 


49 


hdlla 


50 


hdllb 


51 


hdllc 


52 


hdlld 


53 


hdll 6 


54 


hdllf 


55 


hdll.fsck 


56 


hdllh 


57 


hdll. spares 


58 


hdll.drinfo 


59 


hdll.badlist 


60 


hdll. boot 


61 


hdll. restart 


62 


hdll. layout 


63 


hdll.secmap 



Drive 0, Partition 2 

Offset Device 
64 hd02 

79 hd02.secmap 
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Drive 1, Partition 2 

Offset Device 
80 hdl2 

95 hdl2.secmap 



Drive 0, Partition 3 

Offset Device 
96 hd03 

111 hdOS.secmap 



Drive 1, Partition 3 

Offset Device 
112 hdl3 

127 hdlS.secmap 



7 



LAYOUT(M) 



LAY OUT (M) 



There are two additional devices that allow access to the 
entire hard disk: 



Partition Map Creation 

The layout command determines the size and positions of 
userdefinable areas from an ASCII format layout descrip- 
tion file. Default layout descriptions are supplied, and 
may be altered by a knowledgeable user during the hard 
disk creation process. The install script and the 
add.hd(C) script are used to configure the main hard 
drive, and an additional drive, respectively. 

On some machines, the optional Uninterruptible Power 
Supply (UPS) is available (for example, the Altos Series 
2000). In this case, the install script asks you if a 
restart partition is desired, and if it is, whether it is 
to be made the current size of main memory, or the maxi- 
mum possible memory size. This partition is used by the 
autorestart mechanism and may only be installed on the 
main drive. See shutype(M) for further details. 

Next you are asked whether the default layout is accept- 
able for this disk. Select the default layout by deter- 
mining the formatted size of the drive and consulting the 
/etc/layouts/driveclass file, which contains the names of 
default layout configuration files for different drive 
sizes. These files are found in the directory, 
/etc/layouts/defaults. 

If the default layout is not acceptable, as in the case of 
a system that requires a larger-than-normal swap area, a 
dialogue is entered with the user (see the "Example" sec- 
tion that follows). As a result of this dialogue, a new 
layout file is created in the directory, /etc/layouts. 
The format of a layout description file is a collection of 
newline-terminated lines of the form: 

name_of_partition size ofjpartition 

The first field is the name of the partition, the second 
field is the size of the partition in 512-byte blocks. 
The partition name must be a lowercase character in the 



128 hdO. entire 
144 hdl. entire 



All of Drive 0 
All of Drive 1 
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range a through h, or the reserved words .restart and 
•spares. The size field is a decimal number. The parti- 
tion description lines are not required to be in any spe- 
cific order. The /etc/layouts/config file contains a map- 
ping between the names of various user-configurable parti- 
tions and the minor device to which they apply. A sample 
layout file follows. 



a 12320 

b 6726 

c 1O080 

d 1222260 

. spares 152 

. rastart 4096 



Any lines in the layout file with # in colunm 1 are con- 
sidered comments and are ignored. 

The layout command uses the following rules for map crea- 
tion. 

Each partition is allocated in the order it is specified 
in the layout description file. Space is allocated start- 
ing from track 2 of cylinder 0. Unlike previous versions 
of layout y partitions are made exactly the size cited in 
the description file. Likewise, the size of the last par- 
tition will not be automatically adjusted to make room for 
the space required for the maximum number of bad sectors 
on a drive. This number is calculated at a track per 
megabyte of unformatted disk. An advisory message will 
NOT be produced if the last partition spills over in the 
bad sector reserved area. The command line options for 
the partition creation invocation of layout are: 

/etc/layout [-f] [-r m | c] [-d] | [-e] | [-m] 
driveid Idevice 

The value for driveid is a single character that selects 
the drive in question. The main drive's driveid is 0. 
The value for Idevice is usually the raw layout device for 
the specified drive. In the case of the main drive, this 
value is /dev/rhdO. layout. 
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-f This flag indicates that you want to alter a layout. 
A dialogue will begin and a new layout description 
file will be created with the values you specify. 

-r This flag indicates that a restart partition is 

needed. You may choose between a restart partition 
sized the same as the maximum size of memory (m), 
or the current size of memory (c). 

-d This flag indicates that the default layout descrip- 
tion file for this size of disk should be used for 
all further operations. 

-e This flag indicates that an altered layout descrip- 
tion file for this size of disk should be used for 
all further operations. 

-m This flag indicates that the partition map already 
installed on the disk should be used for all further 
operations. 



Layout Viewing 

The -p option prints (on standard output) a representation 
of the layout information for a particular drive. This 
representation consists of the name of the logical device, 
starting block number, and starting block size in 1/2K 
blocks. The numbers are in decimal. The following is an 
example taken from an 80 Mbyte hard disk: 

/etc/layout -p 0 
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produces: 



/dev/hdO 0 131072 
/dev/hdOa 128 12416 
/dev/hdOb 12544 6784 
/dev/hdOc 19328 10112 
/dev/hdOd 29440 100352 
/dev/hdOe 0 0 
/dev/hdOf 0 0 
/dev/hdOg 0 0 
/dev/hdOh 129792 416 
/dev/hdO . spares 16 112 
/dev/hdO. restart 0 0 



The -1 option with partition selector is used to supply 
mkfs(C) with the size to make the corresponding file sys- 
tem. For example, 

/etc/layout -Id 0 

produces: 



100352 



and is best used in the following context: 

DSIZE = Veto/layout -Id 0* 

/etc/mkfs /dev/hdOd >xpr $DSIZE /2^ 4 128 

Besides a through h, the -1 option also takes .restart and 
.spares as acceptable arguments. 

The -c option reads the /dev/hd?.drinfo file and prints 
the decimal values for size of drive in megabytes, number 
of cylinders, number of heads, number of sectors per 
track, numbers of sectors per cylinder, type of drive, and 
recommended interleave if the drive is a SCSI. The fol- 
lowing is the result from an 80 Mbyte ST506-type hard 
disk: 
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do 

1024 

a 

16 
128 
ST505 
0 



Other types of drives are SCSI and ESDI. The -c option 
is intended primarily for the benefit of shell scripts used 
to configure hard disk drives. 



Example 

For example, to add swap space to an additional drive, 
tjTpe layout -f 2 /dev/rhd2. layout. The following menu 
will be displayed: 



l:a 


# 


(extra swap area) 


2:b 


# 


(file system) 


3:c 


0 


(not used) 


4:d 


0 


(not used) 


5:e 


0 


(not used) 


6:f 


0 


(not used) 


7:G 


0 


(not used) 


8:h 


0 


(not used) 


9: . spares 


# 


(spares for grown bad sectors) 


10: 






11: 






12: 






13: . restart 


# 


(restart memory image) 


14 : . extras 




(currently unassigned) 



command q)uit m)ove d)isplay 
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To increase the swap area size (move blo cks to the main 
swap area), type m (for move) and press Bt/4tlW . A mes- 
sage on the screen prompts: 



move blocks from partition #: 



Tj^e 14 (the partition number of currently unassigned 
blocks). You are asked: 



Tj/pe 1 (for the main swap area). When prompted for the 
number of blocks, type the number you want to move from 
partition 14 to 1. Then type d to display the new block 
assignments. Finally, type q to quit. 



move blocks to partition : # ; 



Files 



/etc/layouts/config 



Device map for configurable 
partitions 
Default layout descriptions 
Drive classes file 
Bad-sector map 



/etc/layouts/defaults/* 
/etc/layouts/driveclass 
/dev/hd?. secmap 



See Also 



mknod(C), mkfs(M), shutype(M) 
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Name 

Idunix - Altos configurable kernel linker. 



Syntax 

Idunix [ -d boot directory ] -k kernel file ] 
[ -s system Jile ] 



Description 

Ldunix will link special object file modules produced by 
mkboot(M) creating kernel and symbol table image files. 
These image files can then be processed by mkunix(M) to 
yield a bootable kernel file. 

Ldunix is a utility based on the auto-configuration boot 
procedure. It allows users to reconfigure a unix kernel 
file to reflect changes in tuneable parameters, or the 
addition of special purpose kernel drivers. 

To create the image files, Idunix uses the KERNEL and sys- 
tem files from the current directory and the special ob- 
ject files from the boot.d directory. The -d, -k, and -s 
options can be used to explicitly specify the pathnames 
for Idunix to use for boot.d, KERNEL, and system, respec- 
tively. 

When Idunix links in the modules specified by the master 
files and by the system file, it checks for functions with 
specific names in modules that are drivers. The names 
checked for are formed by concatenating the prefix speci- 
fied in the master file and the desired suffix. For ex- 
ample, in a driver with the prefix "hd," if Idunix is 
checking for the suffix "intr," it will look for the func- 
tion "hdintr." In most cases, if the routine is not found, 
the appropriate table entry gets the entry for the "nodev" 
routine. In the case of the "rstrt," "shut," and "init" 
suffixes, if there is no matching routine, no entry is 
made in the table. 
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The following suffixes are checked by Idunix for each load 
module of the given type: 



block device drivers: 
intr 
open 
close 
strategy 
print 



interrupt handler 
open routine 
close routine 
strategy routine 

routine to call to report device 
errors 



character device drivers (including streams drivers): 



intr 

open 

close 

read 

write 



interrupt handler 
open routine 
close routine 
read routine 
write routine 



all drivers: 
rstrt 



shut 
init 



restart routine to be called when 
power is restored after a power 
failure (if UPS is installed) 

shutdown routine to be called when 
power fails (if UPS is installed) 

routine to be called to initialize the 
driver (called after all other kernel 
initialization is completed) 



Files 



kimage Kernel image file 

ksymbols Kernel symbol table file 



See Also 

mkboot(M), mkunix(M) 
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Name 

link, unlink - Links and unlinks files and directories. 



Syntax 

/etc/link filel file2 
/etc/unlink file 



Description 

The link command is used to create a file name that points 
to another file. Linked files and directories can be re- 
moved by the unlink command; however, it is strongly 
recommended that the rm(C) and rmdir(C) commands be used 
instead of the unlink command. 

The only difference between ln(C) and link/unlink is that 
the latter do exactly what they are told to do, abandoning 
all error checking. This is because they directly invoke 
the link(S) and unlink(S) system calls. 



See Also 

rm(C) and link(S), unlink(S) in the Reference (CP, S, F) 



Notes 

These commands can be run only by the super-user. 
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Name 

log - Interface to STREAMS error logging and event trac- 
ing. 



Description 

Log is a STREAMS software device driver that provides an 
interface for the STREAMS error logging and event tracing 
processes (strerr(M), strace(M)). Log presents two sepa- 
rate interfaces: a function call interface in the kernel 
through which STREAMS drivers and modules submit log mes- 
sages; and a subset of ioctl(S) system calls and STREAMS 
messages for interaction with a user level error logger, a 
trace logger, or processes that need to submit their own 
log messages. 



Kernel Interface 

Log messages are generated within the kernel by calls to 
the function strlog: 

strlog(mid, sid, level, flags, f mt , argl, ...) 
short mid, sid; 
char level; 
ushort flags; 
char *fmt; 

Required definitions are contained in <sys/strlog.h> and 
<sys/log.h>. Mid is the STREAMS module id number for the 
module or driver submitting the log message. Sid is an 
internal sub-id number usually used to identify a particu- 
lar minor device of a driver. Level is a tracing level 
that allows for selective screening out of low priority 
messages from the tracer. Flags are any combination of 
SL_ERROR (the message is for the error logger), SL TRACE 
(the message is for the tracer), SL_FATAL (advisory noti- 
fication of a fatal error), and SL_NOTIFY (request that a 
copy of the message be mailed to the system 
administrator). Fmt is a printf(S) style format string, 
except that %s, %e, %E, %g, and %G conversion specifica- 
tions are not handled. Up to NLOGARGS (currently 3) nu- 
meric or character arguments can be provided. 
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User Interface 

Log is opened via the clone interface, /dev/log. Each 
open of /dev/log obtains a separate stream to log. In 
order to receive log messages, a process must first notify 
log whether it is an error logger or trace logger via a 
STREAMS I_STR ioctl call (see below). For the error log- 
ger, the I_STR ioctl has an ic_cmd field of l ERRLOG, with 
no accompanying data. For the trace logger, the ioctl has 
an ic_cmd field of I_TRCLOG, and must be accompanied by 
a data buffer containing an array of one or more struct 
trace_ids elements. Each trace_ids structure specifies an 
mid, sid, and level from which messages will be accepted. 
Strlog will accept messages whose mid and sid exactly 
match those in the trace_ids structure, and whose level is 
less than or equal to the level given in the trace_ids 
structure. A value of -1 in any of the fields of the 
trace_ids structure indicates that any value is accepted 
for that field. 

At most one trace logger and one error logger can be ac- 
tive at a time. Once the logger process has identified 
itself via the ioctl call, log will begin sending up mes- 
sages subject to the restrictions noted above. These mes- 
sages are obtained via the getmsg(S) system call. The 
control part of this message contains a log_ctl structure 
which specifies the mid, sid, leveU /iags, time in ticks 
since boot that the message was submitted, the correspond- 
ing time in seconds since Jan. 1, 1970, and a sequence 
number. The time in seconds since 1970 is provided so 
that the date and time of the message can be easily co- 
mputed, and the time in ticks since boot is provided so 
that the relative timing of log messages can be deter- 
mined. 

Different sequence numbers are maintained for the error 
and trace logging streams, and are provided so that gaps 
in the sequence of messages can be determined (during 
times of high message traffic some messages may not be 
delivered by the logger to avoid hogging system 
resources). The data part of the message contains the 
unexpanded text of the format string (null terminated), 
followed by NLOGARGS words for the arguments to the for- 
mat string, aligned on the first word boundary following 
the format string. 
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A process may also send a message of the same structure to 
log, even if it is not an error or trace logger. The only 
fields of the log ctl structure in the control part of the 
message that are accepted are the level and flags fields; 
all other fields are filled in by log before being for- 
warded to the appropriate logger. The data portion must 
be packed one word each, on the next word boundary follow- 
ing the end of the format string. 

Attempting to issue an I_TRCLOG or I_ERRLOG when a log- 
ging process of the given type already exists will result in 
the error ENXIO being returned. Similarly, ENXIO is re- 
turned for I_TRCLOG ioctls without any trace_ids struc- 
tures, or for any unrecognized I_STR ioctl calls. Incor- 
rectly formatted log messages sent to the driver by a user 
process are silently ignored (no error results). 

Examples 

Example of I_ERRLOG notification. 

struct strioctl ioc; 
ioc.ic_cmd = I_ERRLOG; 

ioc . ic_timeout = 0; /* default timeout (15 sees.) */ 
ioc.ic_len = 0; 
ioc.ic_dp = NULL; 

ioctldog, I_STR. Sioc) ; 

Example of I-TRCLOG notification. 

struct trace_ids tid[2]; 

tid[0] . ti_mid = 2; 
tid[0] . ti_sid = 0; 
tid[0] . ti_level = 1; 

tid[l] . ti_mid = 1002; 
tid[l] .ti_sid = -1; 
tid[l] . ti_level = -1; 



/* any sub-id will be allowed */ 
/* any level will be allowed */ 
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ioc.ic_cmd = I_TRCLOG; 
ioc. ic_timout = 0; 

ioc.ic_len - 2 * sizeof(struc trace_ids) ; 
ioc.ic_dp = char *)tid; 

ioctKlog, I_STR, &ioc) ; 

Example of submitting a log message (no arguments). 

struct strbuf ctl, dat; 
struct log_ctl Ic; 

char *message = "Don't forget to pick up some milk \ 
on the way home" ; 

ctl.len = ctl.maxlen = sizeof(lc); 
ctl.buf = (char *)&lc; 

dat . len = dat.maxlen ° strlen (message) ; 
dat. but = message; 

Ic . level = 0 ; 

Ic. flags = SL_ERRORSL_NOTIFY; 
putmsg(log, &ctl, &dat, 0); 

Files 

/dev/log 

<sys/log.h> 

<sys/strlog.h> 

See Also 

strace(M), strerr(M), clone(M), and intro(S), getmsg(S), 
putmsg(S) in Reference (CP, S, F) STREAMS ProgTammer's 
Guide 
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Name 

Ipadmin - Configures the LP spooling system. 



Sjoitax 

/usr/lib/lpadmin -pprinter [options] 
/usr/lib/lpadmin -xdest 
/usr/llb/lpadmln -A[dest] 



Description 

Lpadmin configures LP spooling systems to describe print- 
ers, classes, and devices. It is used to add and remove 
destinations, change membership in classes, change devices 
for printers, change printer interface programs and change 
the system default destination. Lpdamin may not be used 
when the LP scheduler, Ipsched(M), is running, except 
where noted below. 

Exactly one of the -d, -p, or -x options must be present 
for every legal invocation of Ipadmin. 

-d[dest] Makes dest, an existing destination, the 

new system default destination. If dest is 
not supplied, then there is no system de- 
fault destination. This option may be used 
when Ipsched(M) is running. No other op- 
tions are allowed with -d. 

-pprinter Names a printer to which all of the options 

below refer. If printer does not exist 
then it will be created. 

-xdest Removes destination dest from the LP sys- 

tem. If dest is a printer and is the only 
member of a class, then the class will be 
deleted, too. No other options are allowed 
with -X. 

The following options are only useful with -p and may ap- 
pear in any order. For ease of discussion, the printer 
will be called P. 
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-cclass Inserts printer P into the specified class. 

Class will be created if it does not al- 
ready exist. 

-eprinteT Names a printer to which all of the options 

below refer. If printer does not exist 
then it will be created. 



-h Indicates that the device associated with P 

is hardwired. This option is assumed when 
creating a new printer unless the -1 option 
is supplied. 

-iinterface Establishes a new interface program for P. 

Interface is the path name of the new pro- 
gram. 

-mmodel Selects a model interface program for P. 

Model is one of the model interface names 
supplied with the LP software (see Models 
below). 



-rclass 



Removes printer P from the specified class. 
If P is the last member of the class^ then 
the class will be removed. 



-vdevice Associates a new device with printer P. 

Device is the path name of a file that is 
writable by the LP administrator, Ip. Note 
that there is nothing to stop an adminis- 
trator from associating the same device 
with more than one printer. If only the -p 
and -V options are supplied, then Ipadmin 
may be used while the scheduler is running. 



Restrictions 

When creating a new printer, the -v option and one of the 
-e, -i, or -m options must be supplied. Only one of the 
-6, -i, or -m options may be supplied. The -h and -1 key- 
letters are mutually exclusive. Printer and class names 
may be no longer than 14 characters and must consist en- 
tirely of the characters A-Z, a-z, 0-9, and _ (underscore). 
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Models 

Model printer interface programs are supplied with the LP 
software. They are shell procedures that interface be- 
tween Ipsched(M) and devices. All models reside in the 
directory /usr/spool/lp/model and may be used as is with 
Ipadmin -m. Models should have 644 permission if owned by 
Ip and bin, or 664 permission if owned by bin and bin. 
Alternatively, LP administrators may modify copies of 
models and then use Ipadmin -i to associate them with 
printers. The following list describes the models and 
lists the options which they may be given on the Ip com- 
mand line using the -o keyletter: 

dumb Interface for a line printer without special 

functions and protocol. Form feeds are assumed. 
Use this model to copy and modify (for printers 
that do not have models). 



Examples 

1. To create a printer named hp2 on port 02, use the 
commands: 

cd /usr/lib 
Ipshut 

xtty disable tty02 

Ipadmin -php2 -v/dev/tty02 -mdumb 
accept hp2 
Ipenable hp2 
Ipsched 

2. To print on hp2, use the command: 

Ip -dhp2 files 



Files 

/usr/spool/lp/* 



See Also 

accept(C), Ipenable(C), lp(C), Ipsched(M), Ipstat(C) 
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Name 

Ipd - Line printer daemon. 



Syntax 

Ipd n 



Description 

The Ipd command is the line printer daemon which supports 
multiple printer spooling. The Ipd command is executed 
automatically by the Ipr(C) command. A single daemon is 
used per printer device, and daemons are invoked only if 
there is currently no daemon active. The Ipd command does 
not engage in any filtering of the data to the printer, 
hence printer control codes, escape sequences and other 
binaries will be reproduced. For serial printers, Ipr(C) 
supplies Ipd with a tty modes setting which is 
non-destructively used to print individual requests. The 
ipd command restores tty modes between each request, and 
at exit time. 

The Ipr command decides whether to invoke the Ipd daemon 
based on the presence (or absence) of a "lock" file in 
each spool directory. A daemon will run until there is no 
more output for its printer. It also removes its lock 
file so that a new daemon may be started up. If the 
daemon were to terminate before removing its lock file, 
the lock file must be removed from its spool directory 
before printing can be resumed. The Ipd command prints an 
optional header (specified in Ipr), followed by a sequence 
of files (each followed by a formfeed). 



Options 

n ]V is a number that selects a spool directory and 
printer device. If n were specified as "2", 
/usr/spool/lpd2 and /dev/lp2 would be selected. If 
no number is supplied, then Ipd assumes /dev/lp and 
/usr/spool/lpd. The Ipr command invokes Ipd with an 
appropriate printer selector digit. 
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Related Commands 



Ipr(C), printers(M) 



Files 



/usr/spool/lpd? 
/dev/lp* 

/usr/spool/lpd? /lock 



spool directories 
printer devices 
lock file 
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Name 

Ipinit - Adds new lineprinters to the system. 



Sjmtax 

/usr/lib/lpinit 



Description 

Lpinlt is a shell script for configuring and adding new? 
lineprinters to a system. It should only be executed by 
the super user. 

Lpinit asks a series of questions for which the default 
answer s are displayed. You can type a response or press 
Itttj'jiiri'MI for the default answer. If you type a response to 
the first question, a Help message is displayed. Lpinit 
prompts for the following information: 

• The print device pathname (default is /dev/lp). 

• The name of the printer (default is linepr). 

• The pathname of the printer interface program 
(default is /usr/spool/lp/model/dumb). 

The printer name can be any combination of up to 14 alpha 
numeric characters or underscores. A printer interface 
program can be a shell script, C program, or any execut- 
able program; or the model interface program, 
/usr/spool/lp/model/dumb, can be copied and modified. 

After you have responded to these questions, ipinit stops 
the print scheduler, Ipsched, changes the acceptance 
status of the new lineprinter to accept, and enables it to 
print files. Lpinit then asks if the new printer will be 
the default printing destination (default is Yes). All 
nonspecific print requests are routed to the default des- 
tinations (see lp(C)). 

The steps to configure a new printer can be taken sepa- 
rately (see Ipadmin(M), accept(C), Ipenable(C), Ipsched(M) 
for details). 
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Files 

/usr/lib/lpinit 
See Also 

accept(C), Ipenable(C), lp(C), Ipadmin(M), Ipsched(M) 
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Name 

Ipon, Ipoff - Turns on/off line printer scheduling. 



Syntax 

Ipon 
Ipoff 



Description 

By default, line printer scheduling is activated in Altos 
System V, version 5.3d. If there is no line printer at- 
tached to the system, this scheduling is superfluous; 
printer scheduling may be stopped, and boot-time startup 
of scheduling permanently disabled by using the Ipoff com- 
mand. If a printer is added to a system that has printer 
scheduling disabled, the Ipon command will start schedul- 
ing and enable boot-time scheduling startup. 



Files 

/etc/init. d/lpsched 

/etc/rc0.d/K361psched 

/etc/rc2.d/S381psched 

/etc/rc2.d/S02.printers 

/etc/rc2.d/s02.printers 



See Also 

lp(C), Ipenable(C), Ipdisable(C) 



1 



LPSCHED(M) 



LPSCHED(M) 



Name 

Ipsched, Ipshut, Ipmove - Starts/stops the LP request 
scheduler and moves requests. 



Syntax 

/usr/lib/lpsched 
/usr/lib/lpshut 

/usr/lib/lpmove request... dest 
/usr/lib/lpmove dest J dest 2 



Description 

Lpsched schedules requests taken by lp(C) for printing on 
line printers. 

Lpshut shuts down the line printer scheduler. Ail print- 
ers that are printing at the time Ipshut is invoked will 
stop printing. Requests that were printing at the time a 
printer was shut down will be reprinted in their entirety 
after Ipsched is started again. All LP commands perform 
their functions even when Ipsched is not running. 

Lpmove moves requests that were queued by lp(C) between 
LP destinations. You can use this command only when 
Ipsched is not running. 

The first form of the command moves the named requests to 
the LP destination, dest. Requests are request ids as 
returned by lp(C). The second form moves all requests for 
destination destl to destination dest2. As a side effect, 
lp(C) will reject requests for destl. 

Note that Ipmove never checks the acceptance status (see 
accept(C)) for the new destination when moving requests. 



Files 

/usr/spool/lp/* 



See Also 

accept(C), lp(C), Ipstat(C) 
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Name 

makedevs - Creates special device files. 

Syntax 

/etc/makedevs directory 

Description 

Makedevs creates all the special device files in the spe- 
cified directory supported by the operating system. 

- Makedevs is normally run to create the device files for 
the hard disk at installation time, and to repair the de- 
vice directory (/dev). 

See Also 

mknod(C) 
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Name 

makekey - Generates an encryption key. 



Syntax 

/usr/lib/makekey 



Description 

Makekey improves the usefulness of encryption schemes by 
increasing the amount of time required to search the key- 
space. It reads 10 bytes from its standard input, and 
writes 13 bytes on its standard output. The output de- 
pends on the input in a way that is intended to be diffi- 
cult to compute (i.e., requires a substantial fraction of 
a second). 

The first eight input bytes (the input key) can be arbi- 
trary ASCII characters. The last two input bytes (the 
salt) are best chosen from the set of digits, dot (.), 
slash (/), and uppercase and lowercase letters. The salt 
characters are repeated as the first two characters of the 
output. The remaining 11 output characters are chosen 
from the same set as the salt and constitute the output 
key. 

The transformation performed is essentially the following: 
the salt is used to select one of 4,096 cryptographic 
machines based on the National Bureau of Standards DES 
algorithm, but broken in 4,096 different ways. Using the 
input key as the key, a constant string is fed into the 
machine and recirculated. The 64 bits that come out are 
distributed into the 66 output key bits in the result. 

Makekey is intended for use with programs that perform 
encryption (e.g., passwd(M)). Usually its input and out- 
put will be pipes. 



See Also 

ed(C), vi(C), passwd(M) 
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Name 

makettys - Creates tty special files. 



Syntax 

/etc/makettys [directory] 



Description 

The makettys command creates all the special files in the 
specified directory (/dev by default) for all the serial 
ports (tty special files) supported by the operating sys- 
tem and installed hardware. 

Execute this command in single-user mode. 

This is done by executing the lOCHOWMANY ioctl to deter- 
mine how many ports are supported for each type of com- 
munications board that is installed. If necessary, it will 
first remove incorrect entries. It will NOT remove spe- 
cial files that are not supported by the current hardware. 
(This could happen after a board has been removed.) 

All files created have the prefix "tty," and up to three 
decimal digits appended. (For compatiblity, ports 1-9 
become ttyOl - tty09.) 

Currently, makettys supports only the SIO and Multidrop 
boards; other devices may be supported in the future. 

Makettys is normally run from /etc/brc on every system 
boot to ensure that all tty devices are correct. 



?'iles 

/dev default directory 



see Also 

mknod(C) 
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Diagnostics 

Messages appear if makettys can't change to the correct 
directory, if it is unable to execute the lOCHOWMANY 
ioctl, or can't create the special files. 

Makettys will not make the pseudo file /dev/tty. 
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Name 

master - Master configuration database. 



Description 

The master configuration database is a collection of 
files. Each file contains configuration information for a 
device or module that may be included in the system. A 
file is named with the module name to which it applies. 
This collection of files is maintained in a directory 
called /usr/sys/master.d. Each individual file has an 
identical format. For convenience, this collection of 
files will be referred to as the master file, as though it 
was a single file. This will allow a reference to the 
master file to be understood to mean the individual file 
in the master, d directory that corresponds to the name of 
a device or module. 

The file is used by the mkboot(M) program to obtain device 
information to generate the device driver and configurable 
module files. It is also used by the sysdef(M) program to 
obtain the names of supported devices. Master consists of 
two parts; they are separated by a line with a dollar sign 
($) in colunm 1. 

• Part 1 contains device information for both hardware 
and software devices, and loadable modules. 

• Part 2 contains parameter declarations used in part 
1. Any line with an asterisk (*) in column 1 is 
treated as a comment. 

Part 1, Description 

Hardware devices, software drivers, and loadable modules 
are defined with a line containing the following informa- 
tion. Field 1 must begin in the left-most position on the 
line. Fields are separated by white space (tab or blank). 
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Field 1: Element characteristics: 



o Specify only once 

r Required device 

b Block device 

c Character device 

a Generate segment descriptor array 

t Initialize cdevsw[].d_ttys 

s Software driver 

f STREAMS driver 

m STREAMS module 

X Not a driver; a loadable module 

number The first interrupt vector for a 
device 



Field 2: Number of interrupt vectors required by a 
hardware device; "-" if none 

Field 3: Handler prefix (4 chars, maximum) 

Field 4: Software driver external major number; "-" if 
not a software driver, or to be assigned during 
execution of Idunix(M) 

Field 5: Number of sub-devices per device; "-" if none 

Field 6: Mask of which CPU's driver can run on; "-" if 
driver doesn't have multiprocessor knowledge 

Field 7: Dependency list (optional); this is a comma 

separated list of other driver or modules that 
must be present in the configuration if this 
module is to be included. 

For each module, two classes of information are required 
by mlcboot(M): 

• External routine references 

• Variable definitions 

Routine and variable definition lines begin with white 
space and immediately follow the initial module specifica- 
tion line. These lines are free form; thus they may be 
continued arbitrarily between non-blank tokens as long as 
the first character of a line is white space. 
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Part 1, Routine Reference Lines 



If the system kernel or other dependent module contains 
external references to a module, but the module is not 
configured, then these external references would be unde- 
fined. Therefore, the routine reference lines are used to 
provide the information necessary to generate appropriate 
dunmiy functions at boot time when the driver is not 
loaded. Routine references are defined as follows: 



Field 1: Routine name () 



Field 2: The routine type: one of 



{ } routinename ( ) { } 

{nosys} routine nameO {return nosysO;} 

{nodev} routine_name() {return nodevO;} 

{false} routine nameO {return 0;} 

{true} routine nameO {return 1;} 

{pass} routinename ( ) {return 
firstargument;} 



Part 1, Variable Definition Lines 



Variable definition lines are used to generate all vari- 
ables required by the module. The variable generated may 
be an arbitrary size, initialized or not, or arrays con- 
taining an arbitrary number of elements. These variables 
are defined as follows: 



Field 1: Variable name 



Field 2: [ expr ] - optional field used to indicate 
array size 

Field 3: (length) - required field indicating the size 
of the variable (see below) 



Field 4: ={ expr,...} - optional field used to 

initialize individual elements of a variable 
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The length field is mandatory. It is an arbitrary se- 
quence of length specifiers, each of which may be one of 
the following: 

%i Integer 
%1 Long integer 

OS Short integer 

%c Single character 

%number Field which is number bytes long 
%numher c Character string which is number 
bytes long 

%vname Length is the value that variable 

name was initialized with in the cor- 
responding boot.d module 



For example, the length field 

(%8cm0x58%l%c%c) 

could be used to identify a variable consisting of a char- 
acter string 8-bytes long, a long integer, a 0x58 byte 
structure of any type, another long integer, and two char- 
acters. Appropriate alignment of each % specification is 
performed {%number is word aligned) and the variable 
length is rounded up to the next word boundary during pro- 
cessing. 

The expressions for the optional array size and initiali- 
zation are infix expressions consisting of the usual oper- 
ators for addition, subtraction, multiplication, and divi- 
sion: +, -, *, and /. Multiplication and division have 
the higher precedence, but parentheses may be used to 
override the default order. The built-in functions min 
and max accept a pair of expressions, and return the ap- 
propriate value. The operands of the expression may be 
any mixture of the following: 

&name Address of name where name is any symbol de- 
fined by the kernel, any module loaded or any 
variable definition line of any module loaded 

#name Size of name where name is any variable name 
defined by a variable definition for any module 
loaded; the size is that of the individual vari- 
able, not of an entire array 
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tiC Number of controllers present; this number is 

determined by the EDT for hardware devices, or 
by the number provided in the system file for 
non-hardware driver or modules 

#C{name) Number of controllers present for the module 

name; this number is determined by the EDT for 
hardware devices, or by the number provided in 
the system file for nonhardware driver or mod- 
ules 



#D Number of devices per controllers taken directly 

from the current master file entry 

ifDiname) Number of devices per controller taken directly 
from the master file entry for the module name 

#M Internal major number assigned to the current 

module if it is a device driver; zero if this 
module is not a device driver 



#M{name) Internal major number assigned to the module 
name if it is a device driver: zero if that 
module is not a device driver 

name Value of a parameter as defined in the second 
part of master 

number Arbitrary number (octal, decimal, or hex 
allowed) 



string Character string enclosed within double quotes 
(all of the character string conventions sup- 
ported by the C language are allowed); this op- 
erand has a value which is the address of a 
character array containing the specified string 



When initializing a variable, provide one initialization 
expression for each %i, %1, %s, or %c of the length field. 
The only initializers allowed for a '%number c' are either 
a character string (the string may not be longer than 
number), or an explicit zero. Initialization expressions 
must be separated by commas, and variable initialization 
will proceed element by element. Note that %number speci- 
fications cannot be initialized — they are set to zero. 
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Only the first element of an array can be initialized, the 
other elements are set to zero. If there are more ini- 
tializers than size specifications, it is an error and 
execution of the mkboot{M) program will be aborted. If 
there are fewer initializations than size specifications, 
zeros will be used to pad the variable. For example: 

={ "V2.L1", #C*#D, max(10,#D), //C(OTHER), //M(OTHER)} 

would be a possible initialization of the variable whose 
length field was given in the preceding example. 

Part 2, Description 

Parameter declarations may be used to define a value sym- 
bolically. Values can be associated with identifiers and 
these identifiers may be used in the variable definition 
lines. 

Parameters are defined as follows: 

Field 1: Identifier (8 characters maximum) 

Field 2: 

Field 3: Value - the value may be a number (decimal, 
octal, or hex allowed), or a string 



Example 

A sample master file for a tty device driver would be 
named atty if the device appeared in the EDT as ATTY. 
The driver is a character device, the driver prefix is at, 
two interrupt vectors are used, and the interrupt priority 
is 6. In addition, another driver named ATLOG is neces- 
sary for the correct operation of the software associated 
with this device. 
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* FLAG #VEC PREFIX SOFT #DEV CPU DEPENDENCIES/ VARIABLES 
tea 2 at - 2 ATLOG 

atpolnt ( ) {false} 
at_tty[#C*#D] (%0x58) 
at_cnt(%i) ={ #C*#D) 
at_logmaj (%i) ={#M(ATLOG)) 
at_id(%8c) ={ ATID) 
at_t able ( %i%l%31%s ) 
={ max(#C ATMAX) , 
fiattty, 
#C } 

$ 

ATID="fred" 
ATMAX=6 

This master file will cause a routine named atpolnt to be 
generated by the mkboot(M) program if the ATTY driver is 
not loaded, and there is a reference to this routine from 
any other module loaded. When the driver is loaded, the 
variables at_tty, at cnt^ atJogmaU at_id, and at table 
will be allocated and initialized as specified. Due to 
the t flag, the d_ttys field in the character device 
switch table will be initialized to point to at_tty (the 
first variable definition line contains the variable whose 
address will be stored in d ttys). The ATTY driver would 
reference these variables by coding: 

extern struct tty at_tty[]; 
extern int at_cnt ; 
extern int at_logma j ; 
extern char at_id[8]; 
extern struct 



int memberl; 
struct tty *member2; 
char junk [ 31 ] ; 
short members; 
} at_table; 
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Files 

/usr/sys/master.d/* 

See Also 

Idunix(M), mkboot{M), sysdef(M) 
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Name 

mem, kmem - Memory image file. 



Description 

The mem file provides access to the computer's physical 
memory. All byte addresses in the file are interpreted as 
memory addresses. Thus, memory locations can be examined 
in the same way as individual bytes in a file. Note that 
accessing a nonexistent location causes an error. 

The kmem file is the same as mem, except that it corres- 
ponds to kernel virtual memory rather than physical mem- 
ory. 

In rare cases, the mem and kmem files may be used to write 
to memory and memory-mapped devices. Such patching is 
not intended for the naive user and may lead to a system 
crash if not conducted properly. Patching device regis- 
ters is likely to lead to unexpected results if the device 
has read-only or write-only bits. 



Files 

/dev/mem 
/dev/kmem 



Notes 

Some of /dev/kmem cannot be read because of write-only 
addresses or unequipped memory addresses. 
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ISJame 

menus - Format of a Business Shell menu system. 



Description 

A menu system is defined as a collection of menus, each of 
which is an ASCII text file. It is relatively easy to 
create a new customized Business Shell (bsh(C)) menu sys- 
tem or to modify the default menu system. The procedure 
to create a menu system follows. 

To create a text file containing the source menu, use the 
following format: 

&Menuidentifier 

. . . the substance of the menu . . 
. . . not over 24 lines length 

&Actions 

. . . zero or more sequences of . 

prompt size 

. . . sequences of actions . . . 
for this prompt . . . 

This sequence may be repeated as often as desired. The 
ampersand (&) and tilde (~) must appear in the first 
column. &Actions must appear, even if there are no ac- 
tions. 

The substances of each menu is composed of text which will 
be reproduced exactly as it appears in the location where 
it appears. There are five exceptions where characters 
have special meanings: 



"~ string" denotes a valid "prompt" string (the text 

of the actual prompt). 

"!date" inserts the current date and time. 

"luser" inserts the current user id, 

"!pwd" inserts the current directory. 

"I@" indicates where to leave the cursor. 
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The "!" may appear as a suffix, in which case the string 
will be right-justified instead of left-justified. 

The prompts must be reproduced as they are expected to be 
typed in the Actions chapter. The actions may be composed 
of bsh commands or commands which are executed by the 
standard shell (/bin/sh). The actions should all be in- 
dented one tab stop. 

Size rows will be reserved at the bottom of the screen for 
output. If size is omitted, a value of 5 will be used. 
If size is 0, the entire screen will be used. After exe- 
cuting the actions, the message 



[Type return to continue] 



will appear at the bottom of the screen. If size is -1 
the entire screen is used, but no message is issued; and 
bsh resumes without pause after all the actions have been 
executed. 

Transfer to another menu is specified by writing the name 
of the destination menu in the semantics field. 

Commands to be executed by the bsh interpreter must be 
typed one-per-line. 

Commands to be executed by the operating system follow 
the usual conventions. 

For example, the menu for Electronic Mail can be created 
as follows: 
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&Mall 



Idate 



\ELECTRONIC"MAIL' SERVICES 



a 



Receive "mail 



b 



c 



Send'mail 

Return "to'start ing'menu 



ScActions 



a 



0 



mail 



b 



-1 



echo -n "To whom do you wish to send mail?" 
read x 

echo "Now type the message. " 

echo "Terminate it by typing a control -d." 

mail $x 



c 



Start 



See Also 



bsh(C), termcap(M) 
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Name 



mkboot - Converts an object file to a bootable object 
file. 



Syntax 



/etc/mkboot [ -m master ] [ -d directory ] [ -k kernel.o ] 
driver. o ... 



Description 

The mkboot command is used to create a bootable object 
file in a format compatible with the self-configuration 
program. It can only be used by the super-user. The ob- 
ject file specified as an argument must have a correspond- 
ing master(M) file in the /usr/sys/etc/master.d directory. 
The master file name for the UNIX system kernel object 
file is always kernel. The other master file names derive 
from their associated object file names in lowercase let- 
ters minus any optional path prefix or ".o" suffix. 

To create the new bootable object file, the applicable 
master file is read and the configuration information is 
extracted. Then, the new bootable file is created con- 
taining this configuration information and written to the 
/usr/sys/boot.d directory. It is given the same name, in 
uppercase letters and without the ".o" suffix, as the ob- 
ject file. Note that if the current working directory is 
/usr/sys/boot.d when mkboot is executed, then the object 
file used is the previous bootable object file residing in 
this directory. This means that you do not have to keep 
separate ".o" files. 

The options are: 

-m master This option specifies the directory con- 

taining the master files to be used for the 
object file. The default master directory 
is /usr/sys/master.d. 

-d directory This option specifies the directory to be 
used for storing the new bootable object 
file. The default output directory is 
/usr/sys/boot.d. 
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-k kernel.o This option specifies the name of the ob- 
ject file for the operating system. The 
master file name used for this object file 
is always named kernel. 

The name of the object file for a module or driver is spe- 
cified by the driver. o argument. 



Example 

mkboot -m newmaster gentty.o 

This will read the file name gentty from the direc- 
tory newmaster for the gentty device configuration 
data, take the file gentty.o from the current direc- 
tory and create the formatted file 
/usr/sys/boot.d/GENTTY containing the configuration 
information for the gentty. 



See Also 

mkunix(M), master (M) 



Diagnostics 

Most messages are self-explanatory. 

name.o: not processed; cannot open /etc/master.d/name 

The file name.o was specified on the command line bul 
there was no master file in the master, d directory 
for name.o. 

name.o: not processed 

An error has aborted processing for the named object 
file. 
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Name 

mkfs - Constructs a file system. 



Syntax 



/etc/mkfs special blocks[:inodes] [gap blocks/cyl] 
/etc/mkfs special proto [gap blocks/cyl] 



Description 



Mkfs constructs a file system by writing on the special 
file using the values found in the remaining arguments of 
the command line. The command waits 10 seconds before 
starting to construct the file system. During this 
10-seco nd pause the command can be aborted by entering a 
delete (MiVEfSi^Atntm). 



If the second argument is a string of digits, the size of 
the file system is the value of blocks interpreted as a 
decimal number. This is the number of physical (512 byte) 
disk blocks the file system will occupy. If the number of 
inodes is not given, the default is the number of logical 
(1024 byte) blocks divided by 4. Mkfs builds a file sys- 
tem with a single empty directory on it. The boot program 
block (block zero) is left uninitialized. 

If the second argument is the name of a file that can be 
opened, mkfs assumes it to be a prototype file proto, and 
will take its directions from that file. The prototype 
file contains tokens separated by spaces or new-lines. A 
sample prototype specification follows (line numbers have 
been added to aid in the explanation): 



1. /stand/ diskboot 

2. 4872 110 

3. d~777 3 1 

4. usr d— 777 

5. sh 

6. ken 
7. 

8. bO 

9. cO 

10. $ 

11. $ 



1 

— 755 3 1 /bin/sh 

d~755 6 1 

$ 

b~644 3 1 0 0 
c~644 3 1 0 0 
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Line 1 in the example is the name of a file to be copied 
onto block zero as the bootstrap program. 

Line 2 specifies the number of physical (512 byte) blocks 
the file system is to occupy and the number of inodes in 
the file system. Lines 3-9 tell mkfs about files and di- 
rectories to be included in this file system. 

Line 3 specifies the root directory. 

Lines 4-6 and 8-9 specifies other directories and files. 

The $ on line 7 tells mkfs to end the branch of the file 
system it is on, and continue from the next higher direc- 
tory. The $ on lines 10 and 11 end the process, since no 
additional specifications follow. 

File specifications give the mode, the user ID, the group 
ID, and the initial contents of the file. Valid syntax 
for the contents field depends on the first character of 
the mode. 

The mode for a file is specified by a 6-character string. 
The first character specifies the type of the file. The 
character range is -bed to specify regular, block special, 
character special and directory files respectively. The 
second character of the mode is either u or - to specify 
set-user-id mode or not. The third is g or - for the 
set-group-id mode. The rest of the mode is a 3 digit oc- 
tal number giving the owner, group, and other read, write, 
execute permissions (see chmod(C)). 

Two decimal number tokens come after the mode; they spec 
fy the user and group IDs of the owner of the file. 

If the file is a regular file, the next token of the spe- 
cification may be a path name whence the contents and si2 
are copied. If the file is a block or character special 
file, two decimal numbers follow which give the major and 
minor device numbers. If the file is a directory, mkfs 
makes the entries . and .. and then reads a list of 
names and (recursively) file specifications for the en- 
tries in the directory. As noted above, the scan is ter- 
minated with the token $. 
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The final argument in both forms of the conmiand specifies 
the rotational gap and the number of blocks/cyl. The fol- 
lowing values are reconmiended: 



Device 



Gap Size Blks/Cyl 



30M Hard Disk 8 

72M Hard Disk 8 

72aM Hard Disk 8 

72bM Hard Disk 8 

72cM Hard Disk 8 

Floppy Disk 4 



90 

162 (CDC Wren II) 
144 (Micropolis) 
198 (Priam) 
198 (Fujitsu) 
18 



Mkfs uses a gap size in multiples of 4. If the gap and 
blocks/cyl are not specified or are considered illegal 
values a default value of gap size 4 and 400 blocks/cyl is 
used. 



See Also 

chmod(C), dir(F), and fs(F) in the Reference (CP, S, F) 



Notes 



With a protot57pe file, it is not possible to copy in a 
file larger than 64K bytes, nor is there a way to specify 
links. The maximum number of inodes configurable is 
65500. 
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Name 

mkunix - Makes a bootable system file with kernel and 
driver sjnnbol tables. 



Syntax 

/etc/mkunlx [ -i kernel Jile ] [ -o unixjile ] 



Description 

The mkunix command will create an absolute, bootable sys- 
tem file {new namelist) from the UNIX system kernel file 
and the object files created by mkboot(M). This procedure 
completes the generation of a new /unix. It can only be 
used by the super-user. 

The resulting unixjile can be used as the kernel Jile for 
ps(C), etc. In addition, this file may be booted di- 
rectly, bypassing the self-configuration phase of the boot 
process. This will save on the order of 30 to 60 seconds 
at boot time. 

Kernel Jile (defaults to the path name specified as the 
BOOT program in the /usr/sys/system file) is read to ob- 
tain the object, data, and symbol table for the basic ker- 
nel. This name, if specified, must be the same as that 
used in /usr/sys/system for the boot line; if not, a warn- 
ing diagnostic is issued since the resulting namelist file 
will not be accurate. 

The argument -o unixjile (defaults to a.out) is the new 
file - a bootable image of the current operating system 
with the composite symbol table. 



See Also 

mkboot(M), ps(C), and nm(CP) in the Reference (CP, S, F) 
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Name 

mnttab - Mounted file system table. 



Syntax 

#include <mnttab.h> 



Description 

The /etc/mnttab file contains a table of devices mounted 
by the mount (C) command. 

Each table entry contains the pathname of the directory on 
which the device is mounted, the name of the device spe- 
cial file, the read/write permissions of the special file, 
and the date on which the device was mounted. 

The maximum number of entries in mnttab is based on the 
system parameter NMOUNT located in /usr/include/mnttab.n, 
which defines the number of allowable mounted special 
files. 



See Also 

mount (C) 
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Name 

multiuser, singleuser - Causes the system to enter 
multi-user or single-user mode. 



Syntax 

/etc/multiuser 
/etc/singleuser 



Description 

This command can only be used by the super-user. 

Multiuser changes the system mode of operation from 
single-user to multi-user. Multiuser performs system 
startup functions such as mounting file systems and start- 
ing various daemons and spoolers. The /etc/telinit 2 com- 
mand is executed to tell init(M) to enter multi-user mode 
(run level 2). 

Singleuser causes the system to kill all currently running 
processes and enter system maintenance mode (run level 1). 



See Also 

init(M), shutdown(M), who(C) 
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Name 

ncheck - Generates path names from inode numbers. 



Syntax 

/etc/ncheck [ -i inode... ] [ -a ] [ -s ] [ file-system ] 



Description 

Ncheck with no arguments generates a path-name vs. inode 
list of all files on a set of default file systems (see 
/etc/checklist). Names of directory files are followed by 
A. 

The options are as follows; 

-i Limits the report to only those files whose inode 
numbers follow. 

-a Allows printing of the names . and .., which are 
ordinarily suppressed. 

-s Limits the report to special files and files with 

set-user-ID mode. This option may be used to detect 
violations of security policy. 

File-system must be specified by the file system's special 
file. The report should be sorted so that it is more 
useful. 



See Also 

fsck(C), sort(C) 



Diagnostics 

If the file system structure is not consistent, ?? de- 
notes the "parent" of a parentless file and a path-name 
beginning with ... denotes a loop. 
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Name 

null - The null file. 
Description 

Data written on a null special file is discarded. Reads 
from a null special file always return 0 bytes. 

Files 

/dev/nuU 
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Name 

options - Floppy disk installation menu. 

Syntax 

options 



Description 

The options conunand displays the installation menu on the 
operating system Root diskette. 

To display this menu, first go to system maintenance mode. 
Then boot the system from the Root File System floppy 
disk. Type options to display the menu. 

Use this menu to initially install or upgrade the operat- 
ing system, restore data from a cartridge tape, shut down 
the system, or exit to the shell. 
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Name 

passwd - The password file. 



Description 

The /etc/passwd file contains the following information 
for each user; 

• Login name 

• Encrypted password 

• Numerical user ID 

• Numerical group ID 

• Comment 

• Initial working directory 

• Program to use as shell 

This is an ASCII file. Each field within each user's en- 
try is separated from the next by a colon (:). The com- 
ment can contain any desired information; it tj^pically 
contains the user's real name. Each user is separated 
from the next by a newline. If the password field is 
null, no password is demanded; if the shell field is null, 
the sh(C) command is used. 

This file resides in the directory /etc. Because the 
passwords are encrypted, the file has general read permis- 
sion and can be used, for example, to map numerical user 
IDs to names. 

The encrypted password consists of 13 characters chosen 
from a 64-character alphabet (., /, 0-9, A-Z, a-z), except 
when the password is null, in which case the encrypted 
password is also null. Password aging is in effect for a 
particular user if his encrypted password in the password 
file is followed by a comma and a nonnull string of char- 
acters from the above alphabet. (Such a string must be 
introduced by the super-user.) The first character of the 
age denotes the maximum number of weeks for which a pa 
word is valid. 
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A user who attempts to log in after his password has ex- 
pired will be forced to supply a new one. The next char- 
acter denotes the minimum period in weeks which must ex- 
pire before the password may be changed. The remaining 
characters define the week (counted from the beginning of 
1970) when the password was last changed. (A null string 
is equivalent to zero.) The first and second characters 
must have numerical value in the range 0-63, where the dot 
(.) is equal to 0 and lowercase z is equal to 63. If the 
numerical value of both characters is 0, the user will be 
forced to change his password the next time he logs in. 
If the second character is greater than the first, only 
the super-user will be able to change the password. 



Files 

/etc/passwd 



See Also 

group(M), login(C), passwd(C) 
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Name 

printers - Printer spooler configuration file. 



Description 

Using the printer spooler facility Ipr(C), you can print a 
specified list of files on one or several line printers. 
Additionally, a printer on a machine connected to WorkNet 
can be shared by other machines on the same net. Such 
printers may need to have an arbitrary set of terminal 
modes set for tab expansion, baud rate, etc. 

The system printer configuration file (/etc/printers) con- 
sists of lines of printer configuration information. 
These include WorkNet machine names, tty types, device 
names, and tty modes. Each line in the /etc/printers file 
is of the form: 

lp[p]:name:ttytype:[netname]:[ttymodes] 

Fields are separated by colons (:) and may not contain 
spaces between the colon separators and field values. The 
length of each line may not exceed 128 characters. Com- 
ments are permitted in the configuration file. A comment 
line begins with in the first column. Any fields sur- 
rounded by "[]" are optional, although their colon sepa- 
rators are not. That is, if a field position is to be 
empty, its place must be marked by two colons (::). 

The fields are: 

lp[p] The printer device selected. Allowable values 
for p are null or 0 - 255. This value is used 
to specify one of several printers. 

name A tag by which a particular configuration line 
can be selected. Allowable values are alpha- 
numeric strings, which do not contain the ":" 
character. 

tty type Exists for the convenience of word processing 
programs that derive printer control sequences 
from /etc/termcap (or similar database). (Not 
used by the printer spooler.) 
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netname May be null, which indicates that spooling is to 
take place on the requestor's machine. Other 
values are network machine names. The print 
spooler uses this name to do remote printing. 

ttymodes A list of whitespace-delimited tty mode specifi- 
cations, such as would be supplied to stty. 



Example 

The following example shows the contents of a printer con- 
figuration file (the contents of /etc/printers): 

# a printer configuration file 

Ip : calcite : NEC3510 : gateway : 

Ip : galena : Oki93 :: -tabs 1200 nl 

IpO: obsidian: 19: Marketing: tabs 9600 nl 

Ipl : feldspar : epson : :nl tabs 9600 

lp2 : mica : TI810 : Finance : 9600 - tabs 

In this example: 

The first line uses the /dev/lp printer on the machine 
named "gateway." The printer type is "NEC3510" and no tty 
modes are set on that printer. This line may be selected 
by specifying "calcite" to Ipr. 

The next line specifies the /dev/lp printer on the user's 
local machine (note the null netname field), is type Oki93 
and sets tab expansion (-tabs), 1200 baud operation, and 
no linefeed to cr-lf expansion. This line is selected 
with the name "galena." 

The third line requests /dev/lpO, is on the Marketing 
machine, runs the printer at 9600 baud, etc., is type 19, 
and is selected by the name "obsidian." 

The last two lines use /dev/lpl on the local machine, and 
/dev/lp2 on the Finance machine. 
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/etc/printers Printer mode control file 

Related Commands 

lpr{C), Ipd(M), tty(M), lp(C) 
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Name 

profile - Sets up an environment at login time. 



Description 

The optional file .profile permits automatic execution of 
commands when a user logs into /bin/sh and other shells 
(except /bin/csh). Use this file to personalize a user's 
worlc environment by setting exported environment variables 
and terminal mode (see environ(M)). 

When a user logs in, the user's login shell looks for 
.profile in the login directory. If found, the shell exe- 
cutes the commands in the file before beginning the ses- 
sion. The commands in the file must match the command as 
if typed at the keyboard. Any line beginning with the 
number sign {#) is considered a comment and is ignored. 
The following is an example of a tjipical file: 

# Tell me when new mail comes In 
MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH : $HOME/bin 

# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

The file /etc/profile is a system-wide profile that, if it 
exists, is executed for every user before the user's 
.profile is executed. 



Files 

$HOME/.profile 
/etc/profile 



See Also 

env(C), mail(C), sh(C), stty(C), su(C), login{M), 
environ (M) 
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Name 

pwck, grpck - Checks password/group file. 



Syntax 

/etc/pwck [file] 
/etc/grpck [file] 



Description 

Pwck scans the password file and notes any inconsisten- 
cies. The checks include validation of the number of 
fields, login name, user ID, group ID, and whether the 
login directory and the program-to-use-as-shell exist. 
The default password file is /etc/passwd. 

Grpck verifies all entries in the group file. This veri- 
fication includes a check of the number of fields, group 
name, group ID, and whether all login names appear in the 
password file. The default group file is /etc/group. 



Files 

/etc/group 
/etc/passwd 



See Also 

groupCM), passwd(M) 



Diagnostics 

Group entries in /etc/group with no login names are 
flagged. 
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Name 

rcO - Runs commands performed to stop the operating 
system. 



Syntax 

/etc/rcO 



Description 

This file is executed at each system state change that 
needs to have the system in an inactive state. It is re- 
sponsible for those actions that bring the system to a 
quiescent state, traditionally called "shutdown." This 
command can be used only by the superuser. 

The system state that requires this procedure is: 

state 0 - system halt state 

Whenever a change to one of these states occurs, the 
/etc/rcO procedure is run. The entry in /etc/inittab 
might read: 

hltO:0:once:/etc/rcO < /dev/console >/dev/console 2>&1 

Some of the actions performed by /etc/rcO are carried out 
by files beginning with K in /etc/rcO.d. These files are 
executed in ASCII order (see files below for more infor- 
mation), terminating some system service. The combination 
of commands in /etc/rcO and files in /etc/rcO.d determines 
how the system is shut down. 

The recommended sequence for /etc/rcO is: 

1. Stop System Services and Daemons. 

Various system services (such as a local area network 
or LP spooler) are gracefully terminated. 

When new services are added that should be terminated 
when the system is shut down, the appropriate files 
are installed in /etc/rcO.d. 
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2. Terminate Processes 

SIGTERM signals are sent to all running processes 
by killall(C). Processes stop themselves cleanly if 
sent SIGTERM. 

3. Kill Processes 

SIGKILL signals are sent to all remaining processes; 
no process can resist SIGKILL. 

At this point the only processes left are those asso- 
ciated with /etc/rcO and processes 5 and 1, which are 
special to the operating system. 

4. Unmount All File Systems 

Only the root file system (/) remains mounted. 

Depending on which system state the system ends up 
in (0 or 6), the entries in /etc/inittab will direct 
what happens next. If the /etc/inittab has not de- 
fined any other actions to be performed as in the 
case of system state 0, then the operating system 
will have nothing to do. It should not be possible 
to get the system's attention. The only thing that 
can be done is to turn off the power or possibly get 
the attention of a firmware monitor. 



Files 

The execution by /bin/sh of any files in /etc/rcO.d occurs 
in ASCII sort-sequence order. See rc2(M) for more infor- 
mation. 



See Also 

killall(C), rc2(M), shutdown(M) 
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Name 

rc2 - Runs commands performed for multi-user environment. 



Syntax 

/etc/rc2 



Description 

This file is executed via an entry in /etc/inittab and is 
responsible for those initializations that bring the sys- 
tem to a ready-to-use state, traditionally state 2, called 
the "multi-user" state. This command can be used only by 
the super-user. 

The actions performed by /etc/rc2 are found in files in 
the directory /etc/red and files beginning with S in 
/etc/rc2.d. These files are executed by /bin/sh in ASCII 
sort-sequence order (see "Files" for more information). 
When functions are added that need to be initialized when 
the system goes multi-user, an appropriate file should be 
added in /etc/rc2.d. 

The functions done by /etc/rc2 command and associated 
/etc/rc2.d files include: 

• Setting and exporting the TZ variable. 

• Setting-up and mounting the user (/usr) file system. 

• Cleaning up (remaking) the /tmp and /usr/tmp direc- 
tories. 

• Loading the network interface and ports cards with 
program data and starting the associated processes. 

• Starting the cron daemon by executing /etc/cron. 

• Cleaning up (deleting) uucp lock, status, and tempo- 
rary files in the /usr/spool/uucp directory. 

Other functions can be added, as required, to support the 
addition of hardware and software features. 
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Examples 

The following are prototypical files found in /etc/rc2.d. 
These files are prefixed by an S and a number indicating 
the execution order of the files. 

MOUNTFILESYS 

# Set up and mount file systems 

cd / 

/etc/mountall /etc/fstab 
RMTMPFILES 

# clean up /tmp 
rm -rf /tmp 
mkdir /tmp 
chmod 777 /tmp 
chgrp sys /tmp 
chown sys /tmp 

UUCP 

# clean-up uucp locks, status, and temporary files 
rm -rf /usr/spool/locks/* 

The file /etc/TIMEZONE is included early in /etc/rc2, 
thus establishing the default time zone for all commands 
that follow. 



FUes 

Here are some hints about files in /etc/red: 

The order in which files are executed is important. Since 
they are executed in ASCII sort-sequence order, using the 
first character of the file name as a sequence indicator 
will help keep the proper order. Thus, files starting 
with the following characters would be: 

[0-9] very early 
[A-Z] early 
[a-n] later 
[o-z] last 

Files in /etc/red that begin with a dot (.) will not be 
executed. This feature can be used to hide files that are 
not to be executed for the time being without removing 
them. 
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Files in /etc/rc2.d must begin with an S or a K followed 
by a number and the rest of the file name. Upon entering 
run level 2, files beginning with S are executed with the 
start option; files beginning with K, are executed with 
the stop option. Files beginning with other characters 
are ignored. 



See Also 

rcO(M), shutdown(M) 
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Name 

sadcon, sadcoff - Turns on/off system activity data col- 
lector. 



Syntax 

sadcon 
sadcoff 



Description 

By default, the system activity data collector is deacti- 
vated in Altos System V, version 5.3d. The data collector 
may be started, and boot-time startup of the collector 
enabled by using the sadcon command. A subsequent sadcoi 
conmiand will disable boot-time data collector startup. 



Files 

/etc/init.d/sadc 
/etc/rc2.d/S34sadc 
/usr/spool/cron/crontabs/sys 
/usr/spool/cron/crontabs/adm 



See Also 

sar(C), cron(C) 
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Name 

sar: sal, sa2, sadc - System activity report package. 



Syntax 

/usr/llb/sa/sadc [t n] [of He] 
/usr/lib/sa/sal [f n] 

/usr/lib/sa/sa2 [-ubdycwaqvmprSDA] [-s time] [-e time] 
[-i sec] 



Description 

System activity data can be accessed at tiie special re- 
quest of a user (see sar(C)) and automatically on a rou- 
tine basis as described here. The operating system con- 
tains a number of counters that are incremented as various 
system actions occur. These include counters for CPU 
utilization, buffer usage, disk and tape I/O activity, TTY 
device activity, switching and system-call activity, 
file-access, queue activity, inter-process communications, 
paging, and Remote File Sharing. 

Sadc and shell procedures, sal and sa2, are used to 
sample, save, and process this data. 

Sadc, the data collector, samples system data n times 
every t seconds and writes in binary format to ofile or to 
standard output. If t and n are omitted, a special record 
is written. This facility is used at system boot time, 
when booting to a multiuser state, to mark the time at 
which the counters restart from zero. For example, the 
/etc/init.d/perf file writes the restart mark to the daily 
data by the command entry: 

su sys -c "/usr/lib/sa/sadc /usr/adm/sa/saMate +%d"" 

The shell script sal, a variant of sadc, is used to col- 
lect and store data in binary file /usr/adm/sa/sardd where 
dd is the current day. The arguments f and n cause 
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records to be written n times at an interval of t seconds, 
or once if omitted. The /usr/spool/cron/crontabs/sys 
(see cron(C)) entries: 

0 * * * 0-6 /usr/lib/sa/sal 

20,40 8-17 * * 1-5 /usr/lib/sa/sal 

will produce records every 20 minutes during working hours 
and hourly otherwise. 

The shell script sa2 writes a daily report in file 
/usr/adm/sa/sardd. The /usr/spool/cron/crontabs/sys en- 
try: 

5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A 

will report important activities hourly during the working 
day. The structure of the binary daily data file is: 

struct sa 



struct sysinfo si; 
struct minfo mi; 
struck dinfo di: 
int minserve, tnaxserve; 



/* see/usr/include/sys/sysinf o . h */ 

/* defined in sys/sysinfo. h */ 

/* RFS info defined in sys/sysinfo . h */ 

/* RFS server Jow and high water 

* marks */ 



int szinode; 


/* 


current 


size of inode table */ 


int szfile; 


/* 


current 


size of file table */ 


int szproc; 


/* 


current 


size of proc table */ 


int szlckf; 


/* 


current 


size of file record header table */ 


int szlckr; 


/* 


current 


size of file record lock table */ 


int mszinode; 


/* 


size of 


inode table */ 


int mszfile; 


/* 


size of 


file table */ 


int mszproc; 


/* 


size of 


proc table */ 


int mszlckf; 


/* 


maximum 


size of file record header table */ 


int mszlckr; 


/* 


maximum 


size of file record lock table */ 


long inodeovf ; 


/* 


cumulative overflows of inode table */ 


long fileovf; 


/* 


cumulative overflows of file table */ 


long procovf ; 


/* 


cumulative overflows of proc table */ 


time_t ts; 


/* 


time stamp, seconds */ 


long devio[NDEVS] [4] ; 


/* 


device unit information */ 


#define IO_OPS 


0 


/* 


cumulative I/O requests */ 


#define IO_BCNT 


1 


/* 


cumulative blocks transferred */ 


#define IO_ACT 


2 


/* 


cumulative drive busy time in ticks 


#define IO_RESP 


3 


/* 


cumulative I/O resp time in ticks * 
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Files 

/usr/adm/sa/sadd 
/usr /adm/sa/sardd 1 
/tmp/sa.adrfl 



Daily data file 
Daily report file 
Address file 



See Also 



cron(C), sar(C) 
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Name 



shutdown - Brings a system to single-user mode or to shut- 
down. 



Syntax 



/etc/shutdown [ -y ] [ -ggrace_period ] [ -iinit state ] 



Description 



This command is executed by the super-user to change the 
state of the machine. By default, it brings the system 
to a state where only the console has access to the 
system. This state is traditionally called "single-user." 

The command sends a warning message (via wall(C)) and a 
final message before it starts actual shutdown activities. 
By default, the command asks for confirmation before it 
starts shutting down daemons and killing processes. The 
options are as follows: 



-y Pre-answers the confirmation question so 

the command can be run without user 
intervention. A default of 60 seconds is 
allowed between the warning message and 
the final message. Another 60 seconds is 
allowed between the final message and the 
confirmation. 



-ggr ace period Allows the super-user to change the numbe 
of seconds from the 60-second default. Yc 
can specify a number from 0 to 999 to de- 
lay shutdown for that amount of time fol- 
lowing notification to the users. If 0 is 
entered, shutdown will be immediate, and i 
no parameter is given, 60 seconds is as- 
sumed. 



-Unit _st ate Specifies the state that init(M) is to be 
put in following the warnings, if any. By 
default, system state "s" is used (the 
same as states "1" and "S"). 
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Other recommended system state definitions are: 

state 0 Shut the machine down so it is safe to remove 
the power. Have the machine remove power if 
it can. The /etc/rcO procedure is called to so 
this work. 

state 1, s, S 

Bring the machine to the state traditionally 
called single-user. The /etc/rcO procedure is 
called to do this work. (Though s and 1 are 
both used to go to single-user state, s only 
kills processes spawned by init and does not 
unmount file systems. State 1 unmounts 
everything except root and kills all user 
processes, except those that relate to the 
console. 

states Stop the system and go to the firmware monitor. 

state 6 Stop the system and reboot to the state defined 
by the initdefault entry in /etc/inittab. 



See Also 

wall(C), init(M), rcO(M), rc2(M) 
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Name 



shutype - UPS shutdown configuration utility. 



Syntax 



shutype [-p] [-ttype] [-ffailtime] [-cpwrcnt] [-uupstime] 
[wpwrtime] [-etermtime] 



Description 



The shutype command allows the alteration of the current 
configurable settings for a UPS power failure condition. 
The six configuration settings that can be changed are: 



-ttype The type of shutdown that is to be initi- 

ated for a power failure condition. This 
option causes the following to occur: the 
shutkill command issues a SIGPWR signal t( 
all processes, and then posts SIGTERM and 
SIGKILL signals to the processes; a sync(S: 
command is then executed to maintain the 
integrity of the file system; a shutsave 
command delivers the SIGPWR signal to all 
processes, but saves memory to disk so a 
later restart can be attempted. 

-ffailtime The time in ticks to wait to check for a 

power failure condition after the first 
power failure condition was detected. Thij 
is used to check if a power glitch only has 
occurred. 



-cpwrcnt The maximum number of power failure intei 

rupts that can occur within the above 
FAILTIME time interval before the power 
source is considered to be unreliable. 



-uupstime The time in seconds that the UPS battery 

backup unit can operate reliably after 
power has been turned off. 



-wpwrtime The time in seconds for the system to wait 
after posting the SIGPWR signal to all pro 
cesses before initiating shutdown proce- 
dures. 
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-etermtime The time in seconds for the system to wait 
after posting the SIGTERM signal to all 
processes before posting the SIGKILL signal 
to all processes. This is only used when 
the shutkill option is in effect. 

If no options are given, shutype will prompt you for each 
of the above parameters. A null response followed by a 
carriage return will leave the current configuration value 
the same. 

The -p option will print out the current settings of the 
above mentioned configurable parameters. No other options 
are allowed to be given with the -p option. 

A sanity check will be done on any and all of the values 
entered. If the shutdown type is shutkill, the total 
times of termtime^ pwrtimey and failtime cannot exceed the 
value of upstime. 

If the shutdown type is shutsave, the total times of 
pwrtime and failtime plus the estimated disk output time 
cannot exceed upstime. The estimated disk output time 
will be printed if no options are given, or the -p option 
is given. If there are any inconsistencies, appropriate 
error message will be output. 

Only the super-user is allowed to change any of the above 
mentioned configurable parameters. 



See Also 

shuttype(S) 
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Name 

strace - Prints STREAMS trace messages. 



Syntax 

strace [ mid sid level ]... 



Description 

Strace without arguments writes all STREAMS event trace 
messages from all drivers and modules to its standard out- 
put. These messages are obtained from the STREAMS log 
driver (log(M)). If arguments are provided they must be 
in triplets of the form mid, sid, level, where mid is a 
STREAMS module id number, sid is a sub-id number, and 
level is a tracing priority level. Each triplet indicates 
that tracing messages are to be received from the given 
module/ driver, sub-id (usually indicating minor device), 
and priority level equal to or less than the given level. 
The token all may be used for any member to indicate no 
restriction for that attribute. 

The format of each trace message output is: 

<seq> <time> <ticks> <level> <flags> <mid> <sid> <fext> 

where: 

<scq> trace sequence number 

<time> time of message in hh:nmi:ss 

<ticks> time of message in machine ticks since boot 

<level> tracing priority level 

<flags> E: message is also in the error log 

F: indicates a fatal error 

N: mail was sent to the system administrator 
<mid> module id number of source 
<sid> sub-id number of source 
<fext> formatted text of the trace message 

Once initiated, strace will continue to execute until ter- 
minated by the user. 
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Examples 

Output all trace messages from the module or driver whose 
module id is 41: 

strace 41 all all 

Output those trace messages from driver /module id 41 with 
sub-ids 0, 1, or 2: 

strace 41 0 1 41 1 1 41 2 0 

Messages from sub-ids 0 and 1 must have a tracing level 
less than or equal to 1. Those from sub-id 2 must have a 
tracing level of 0. 



Notes 

Due to performance considerations, only one strace process 
is permitted to open the STREAMS log driver at a time. 
The log driver has a list of the triplets specified in the 
command invocation, and compares each potential trace mes- 
sage against this list to decide if it should be formatted 
and sent up to the strace process. Hence, long lists of 
triplets will have a greater impact on overall STREAMS 
performance. Running strace will have the most impact on 
the timing of the modules and drivers generating the trace 
messages that are sent to the strace process. If trace 
messages are generated faster than the strace process can 
handle them, then some of the messages will be lost. This 
last case can be determined by examining the sequence num- 
bers on the trace messages output. 



See Also 

log(M), and STREAMS ProgrammeT's Guide 
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Name 

strclean - STREAMS error logger cleanup program. 



Syntax 

strclean [ -d logdir ] [-a age ] 



Description 

Strclean is used to clean up the STREAMS error logger di- 
rectory on a regular basis (for example, by using 
cron(M)). By default, all files with names matching 
error.* in /usr/adm/streams that have not been modified in 
the last 3 days are removed. A directory other than 
/usr/adm/streams can be specified using the -d option. 
The maximum age in days for a log file can be changed us- 
ing the -a option. 



Example 

strclean -d/usr/adm/streams -a 3 
has the same result as running strclean with no arguments. 



Notes 

strclean is tj^pically run from cron(M) on a daily or 
weekly basis. 



Files 

/usr/adm/streams/error. * 



See Also 

cron(C), strerr(M), and STREAMS Programmer's Guide 
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Name 

strerr - STREAMS error logger daemon. 



Sj^tax 

strerr 



Description 

Strerr receives error log messages from the STREAMS log 
driver (log(M)) and appends them to a log file. The error 
log files produced reside in the directory 
/usr/adm/streams, and are named error, mm-dd, where mm is 
the month and dd is the day of the messages contained in 
each log file. 

The format of an error log message is: 

<seq> <time> <ticks> <flags> <mid> <sid> <text> 

where: 

<seq> error sequence number 
<time> time of message in hh:nmi:ss 
<ticksy time of message in machine ticks since boot 
<flags'> T: message was also sent to a tracing process 
F: indicates a fatal error 
N: send mail to the system administrator 
<mid> module id number of source 
<sid> sub-id number of source 
<fcxf> formatted text of the error message 

Messages that appear in the error log are intended to re- 
port exceptional conditions that require the attention of 
the system administrator. Those messages which indicate 
the total failure of a STREAMS driver or module should 
have the F flag set. Those messages requiring the immedi- 
ate attention of the administrator will have the N flag 
set, which causes the error logger to send the message to 
the system administrator via mail(C). Messages with a 
module id of 0 are generated by the kernel. 
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Notes 

Only one strerr process at a time is permitted to open the 
STREAMS log driver. If a module or driver is generating c 
large number of error messages, running the error logger 
will cause a degradation in STREAMS performance. If a 
large burst of messages are generated in a short time, the 
log driver may not be able to deliver some of the mes- 
sages. This situation is indicated by gaps in the se- 
quence numbering of the messages in the log files. 



Files 

/usr /adm/streams/error. mm-dd 



See Also 

log(M), and STREAMS Programmer's Guide 
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Name 

sulogin - Special login program invoked by init (via 
/etc/inittab) to bring the machine up in single-user or 
multi-user mode. 



Syntax 

sulogin 



Description 

Sulogin prompts you for system maintenance (single-user) 
mode or multi-user mode. 

If you select single-user mode by typing a valid root 
password, the system is brought up in system maintenance 
(single-user) mode by executing the shell script 
/etc/sin gleuser. If you select multiuser mode by typing 
KWiiBiB . or there is no reponse for 5 seconds, sulogin will 
execute the shell script file /etc/multiuser, which will 
bring the system up in multi-user mode. 



Files 

/etc/multiuser 

/etc/singleuser 

/etc/inittab 



See Also 

init(M) 
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Name 



sysdef - Outputs system definition. 



Syntax 



/etc/sysdef [ system namelist [ master. d ] ] 



Description 



Sysdef outputs the current system definition in tabular 
form. It lists all hardware devices, their local bus ad- 
dresses, and unit count, as well as pseudo devices, system 
devices, loadable modules and the values of all tunable 
parameters. It generates the output by analyzing the 
named operating system file (system namelist) and extract- 
ing the configuration information from the name list it- 
self. The operating system file must be an "absolute" 
boot file (see mkunix(M)). 



mkunix(M), master(M), and nlist(S) in the Reference 
(CP, S, F) 



internal name list overflow 

if the master table contains more than an internally 
specified number of entries for use by nlist(S). 



Files 



/unix 



Default operating system file 
(where the system namelist is) 

Default directory containing 
master files 



/usr/sys/master.d/* 



See Also 



Diagnostics 
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Name 

term - Compiled term file. 



Description 

Compiled terminfo descriptions are placed under the direc- 
tory /usr/lib/terminfo. To avoid a linear search of a 
huge system directory, a two-level scheme is used: 
/usr/lib/terminfo/c/name where name is the name of the 
terminal, and c is the first character of name. Thus, 
act4 can be found in the file /usr/lib/terminfo/a/act4. 
Synonyms for the same terminal are implemented by multiple 
links to the same compiled file. 

The format has been chosen so that it will be the same on 
all hardware. An eight (or more) bit byte is assumed, but 
no assumptions about byte ordering or sign extension are 
made. 

The compiled file is created with the terminfo compiler 
(tic(C)) program, and read by the routine setupterm(S). 
Both of these pieces of software are part of curses(S). 
The file is divided into six parts: the header, terminal 
names, boolean flags, numbers, strings, and string table. 

The headers section begins the file. This section con- 
tains six short integers in the following format. 

• The magic number (octal 0432). 

• The size, in bytes, of the names section. 

• The number of bytes in the boolean section. 

• The number of short integers in the numbers section. 

• The number of offsets (short integers) in strings 
section. 

• The size, in bytes, of the string table. 

Short integers are stored in two 8-bit bytes. The first 
byte contains the least significant 8 bits of the value, 
and the second byte contains the most significant 8 bits. 
(Thus, the value represented is 256*second+f irst. ) The 



1 



TERM(M) 



TERM(M) 



value -1 is represented by 0377,0377; other negative 
values are illegal. The -1 generally means that a capa- 
bility is missing from this terminal. Machines where this 
does not correspond to the hardware read the integers as 
two bytes and compute the result. 

The terminal names section comes next. It contains the 
first line of the terminfo description, listing the var- 
ious names for the terminal, separated by the ' | ' charac- 
ter. The section is terminated with an ASCII NUL charac- 
ter. 

The boolean flags have one byte for each flag. This byte 
is either 0 or 1 as the flag is present or absent. The 
capabilities are in the same order as the file <term.h>. 

Between the boolean section and the number section, a null 
byte will be inserted, if necessary, to ensure that the 
number section begins on an even byte. All short integers 
are aligned on a short word boundary. 

The numbers section is similar to the flags section. Each 
capability takes up two bytes, and is stored as a short 
integer. If the value represented is -1, the capability 
is taken to be missing. 

The strings section is also similar. Each capability is 
stored as short integer, in the format above. A value of 
-1 means the capability is missing. Otherwise, the value 
is taken as an offset from the beginning of the string 
table. Special characters in "X or /c notation are stored 
in their interpreted form, not the printing representa- 
tion. Padding information $<nn> and parameter information 
=%x are stored intact in uninterpreted form. 

The final section is the string table. It contains all 
the values of string capabilities referenced in the string 
section. Each string is null terminated. 

Note that it is possible for setupterm to expect a differ- 
ent set of capabilities than are actually present in the 
file. Either the database may have been updated since 
setupterm has been recompiled (resulting in extra unrecog- 
nized entries in the file) or the program may have been 
recompiled more recently than the database was updated 
(resulting in missing entries). The routine setupterm 
must be prepared for both possibilities ~ this is why the 
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numbers and sizes are included. Also, new capabilities 
must always be added at the end of the lists of boolean, 
number, and string capabilities. 

Some limitations: total compiled entries cannot exceed 
4096 bytes. The name field cannot exceed 128 bytes. 



Files 

/usr/lib/terminfo/*/* Compiled terminal capability data 

base 



See Also 

terminfo(M) 
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Name 

termcap - Terminal capability database. 



Description 

The file /etc/termcap is a data base describing terminals. 
Terminals are described in termcap by a set of capabili- 
ties and how operations are performed. Padding require- 
ments and initialization sequences are included in 
termcap. Note that the use of term{M) is preferred. 

Entries in termcap consist of a number of ':' separated 
fields. The first entry for each terminal gives the names 
known for the terminal, separated by vertical bar ( | ) 
characters. The first name is always 2 characters long 
for compatibility with older systems. The second name 
given is the most common abbreviation for the terminal, 
and the last name given should be a long name fully iden- 
tifying the terminal. The second name should contain no 
blanks; the last name may well contain blanks for read- 
ability. 



Capabilities 

The following is a list of the capabilities that can be 
defined for a given terminal. In this list (P) indicates 
padding may be specified, and (P*) indicates that padding 
may be based on the number of lines affected. 



Name 


Type 


Pad? 


Description 


ae 


str 


(P) 


End alternate character set 


al 


str 


(P*) 


Add new blank line 


am 


bool 




Terminal has automatic margins 


as 


str 


(P) 


Start alternate character set 


be 


str 




Backspace if not 


BE 


str 




Bell character 


bs 


bool 




Terminal can backspace with 


BS 


str 




Sent by BACKSPACE key (if not be) 


bt 


str 


(P) 


Back tab 


bw 


bool 




Backspace wraps from column 0 to 



last column 
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Name 


Type 


Pad? 


Description 


CC 


str 




Command character in protot3^e if 








terminal settable 


cd 


str 


(P*) 


Clear to end of display 


ce 


str 


(P) 


Clear to end of line 


CF 


str 




Cursor off 


ch 


str 


(P) 


Like cm but horizontal motion only, 








line stays same 


CL 


str 




Sent by CHAR LEFT key 


CI 


str 


\r ) 


v_/icar ocreeii 


cm 


str 


(P) 


Cursor motion 


CN 


str 




Sent by CANCEL key 


CO 


num 




Number of columns in a line 


CO 


str 




Sent by CHAR RIGHT key 


cr 


str 


(P*) 


Carriage return, (default "M) 


cs 


str 


(P) 


Change scrolling region (vtlOO), like 


cv 


str 


(P) 


cm 

Like ch but vertical only 


CW 


str 




Sent by CHANGE WINDOW key 


da 


bool 




Display may be retained above 


db 


bool 




Display may be retained below 


dB 


num 




Number of millisec of bs delay 


dC 


num 




Number of millisec of cr delay 


dc 


str 


(P*) 


Delete character 


dF 


num 




Number of millisec of ff delay 


DK 


str 




Sent by down arrow key (if not kd) 


DL 


str 




Sent by DELETE key 


DL 


str 




Sent by destructive character delete 








key 


dl 


str 


(P*) 


Delete line 


dm 


str 




Delete mode (enter) 


dN 


number 




Number of millisec of nl delay needed 


do 


str 




Down one line 


ed 


str 




End delete mode 


EE 


str 




FHit mndp pnd 


EG 


num 




Number of chars taken by ES and EE 


ei 


str 




End insert mode; give ':ei=:' 


EN 


str 




Sent by END key 


eo 


str 




Erase overstrikes with a blank 


ES 


str 




Edit mode start 


ff 


str 


(P*) 


Hardcopy terminal page eject (default 
^L) 


Gl 


str 




Upper-right (1st quadrant) corner 



character 
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Name 


Type 


Pad? 


Description 


G2 


str 




Upper-left (2nd quadrant) corner 








character 


G3 


str 




Lower-left (3rd quadrant) corner 








character 


G4 


str 




Lower-right (4th quadrant) corner 








character 


GD 


str 




Down-tick character 


GE 


str 




Graphics mode end 


GG 


num 




Number of chars taken by GS and G 


GH 


str 




Horizontal bar character 


GS 


str 




Graphics mode start 


GU 


str 




Up-tick character 


GV 


str 




Vertical bar character 


he 


bool 




Hardcopy terminal 


hd 


str 




Half -line down (forward 1/2 linefeed 


hz 


str 




Hazeltine; can't print 's 


ic 


str 


(P) 


Insert character 


if 


str 




Name of file containing is 


im 


bool 




Insert mode (enter); give ':im=:q' if 
ic 


in 


bool 




Insert mode distinguishes nulls on 








display 


ip 


str 


(P*) 


Insert pad after character inserted 


is 


str 




Terminal initialization string 


k0-k9 


str 




Sent by 'other' function keys 0-9 


kb 


str 




Sent by backspace key 


kd 


str 




Sent by terminal down arrow key 


ke 


str 




Out of 'keypad transmit' mode 


KF 


str 




Key-clock off 


kh 


str 




Sent by home key 


kl 


str 




Sent by terminal left arrow key 


kn 


num 




Number of 'other' keys 


KO 


str 




Key-clock on 


ko 


str 




Termcap entries for other 








non-function keys 


kr 


str 




Sent by terminal right arrow key 


Iro 
KS 


str 




irui leniiiiiai in Keypau transmit 








mode 


dT 


num 




Number of millisec of tab delay 








needed 


ku 


str 




Sent by terminal up arrow key 


10-19 


str 




Labels on 'other' function keys 


LD 


str 




Sent by line delete key 
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Name 


Type 


Pad? 


Description 


LF 


str 




Sent by line feed key 


li 


num 




Number of lines on screen or page 


LK 


str 




Sent by left arrow key (if not kl) 


11 


str 




Last line, first column (if no cm) 


ma 


str 




Arrow key map, used by vi version 2 








only 


mi 


bool 




Safe to move while in insert mode 


ml 


str 




Memory lock on above cursor 


MN 


str 




Sent by minus sign key 


MP 


str 




Multiplan initialization string 


MR 


str 




Multiplan reset string 


mil 


str 




Memory unlock (turn off memory lock) 


nc 


bool 




No correctly working carriage return 








(DM25000,H2000) 


nd 


str 




Non-destructive space (cursor right) 


nl 


str 


(P*) 


Newline character (default /n) 


ns 


bool 




Terminal is a CRT but doesn't scroll 


NU 


str 




Sent by NEXT UNLOCKED CELL key 


OS 


bool 




Terminal overstrikes 


DC 


str 




Pad character (rather than null 


PD 


str 




Sent by PAGE DOWN key 


PL 


str 




Sent by PAGE LEFT key 


PR 


str 




Sent by PAGE RIGHT key 


PS 


str 




Sent by plus sign key 


Dt 


bool 




Has hardware tabs (may need to be 








set with is) 


PU 


str 




Sent by PAGE UP key 


RC 


str 




Sent by RECALC key 


RF 


str 




Sent by TOGGLE REFERENCE key 


RK 


str 




Sent by right arrow key (if not kr) 


RT 


str 




Sent by RETURN key 


RT 


str 




Sent by return key 


se 


str 




End stand out mode 


sf 


str 


(P) 


Scroll forward 




num 




Number of blank chars left by so or 


SO 


str 




se 

Begin stand out mode 


sr 


str 


(P) 


Scroll reverse (backwards) 


ta 


str 


(P) 


Tab (other than "I or with padding) 


TB 


str 




Sent by TAB key 


tc 


str 




Entry of similar terminal - must be 








last 


te 


str 




String to end programs that use cm 
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Name 


Type 


Pad? Description 


ti 


str 


String to begin programs that use cm 


uc 


str 


Underscore one char and move past 11 


ue 


0-4-*- 

str 


End underscore mode 


ug 


num 


Number of blank chars left by use or 




str 


ue 

Sent by up arrow key (if not ku) 


111 

Ui 


bool 


Terminal underlines even though it 






doesn't overstrike 


up 


str 


Upline (cursor up) 


us 


str 


Start underscore mode 


VD 


str 


Visible bell (may not move cursor) 


ve 


str 


Sequence to end open/ visual mode 


vs 


str 


Sequence to start open/visual mode 


WK 


str 


bent by wukd kioHI key 


XD 


bool 


Beehive (fl=escape, f2=ctrl C) 


xn 


bool 


A newline is ignored after a wrap 








xr 


bool 


Return acts like ce /r /n (Delta 






Data) 


xs 


bool 


Standard out not erased by writing 






over it (HP 264?) 


xt 


bool 


Tabs are destructive, magic so char 






(Teleray 1061) 



A Sample Entry 

Entries may continue onto multiple lines by giving a \ as 
the last character of a line, and empty fields may be in- 
cluded for readability (here between the last field on a 
line and the first field on the next). Capabilities in 
termcap are of three types: 

• Boolean capabilities which indicate that the terminal 
has some particular feature. 

• Numeric capabilities giving the size of the terminal 
or the size of particular delays 

• String capabilities, which give a sequence which can 
be used to perform particular terminal operations. 
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The following entry describes the Altos II terminal. 

a2|altos2|alt2|altos 2 | Altos II :\ 

:cd=\E[J:ce=\E[K:cl=\E:cl=\E[ ;H\E[2J:\ 

:up=\E[lA:do=\E[lB:nd=\E[lC:bc=\E[lD:cm=\E[%i%d;%dH:ho=\E[H:\ 
:al=\E[L:dl=\E[M:ic=\E[e:dc=\E[P:im=:ei=:\ 
: co#80 : li#24 : ug#0 : sg#0 : bs : pt : sr : \ 
:so=\E[7m:se=\E[m:us=\E[4m:ue=\E[in: \ 

:is=\E>\E[?31\E[?41\E[?51\E[?7h\E[?8H:if=/usr/lib/tabset/vtl00:\ 
:ku=\E[A:kd=\E[B:kr=\E[C:kl=\E[D:kh=\E[f :kb=~H:cr="M:\ 



xu- 


"Aq\r; 


:XD== 


"Ar\r; 


;XR= 


*As\r; 


XL- 


*At\r 


:\ 


yu= 


-AQ\r; 


;YD= 


-AR\r: 


:YR= 


"AS\r; 


;YL= 


*AT\r: 


:\ 


HL- 


"AP\r ; 


:\ 














IS = 


\E[@:DE=\E[P:IL=\E[L:DL= 


=\E[M:NS=\E| 


L0= 


\E[Oq:LC= 


\E[5q: 


:LL= 


\E[6q: 


;\ 






kO = 


"A@\r: 


:kl= 


-AA\r: 


:k2 = 


"AB\r: 


;k3 = 


"AC\r 


:\ 


K4 = 


"AD\r: 


;k5 = 


"AE\r: 


:k6 = 


*AF\r; 


:k7= 


-AG\r 


:\ 


k8 = 


"AH\r; 


:k9 = 


-AI\r ; 


;kA= 


"AJ\r ; 


:kB= 


"AK\r 


:\ 


kC= 


"AL\r: 


;kD= 


"AM\r: 


:kE= 


*AN\r; 


;kF= 


"AO\r 


:\ 


cO= 


~A"\r: 


:cl= 


"Aa\r ; 


:c2 = 


"Ab\r ; 


;c3 = 


"Ac\r 


:\ 


c4= 


*Ad\r; 


;c5 = 


"Ae\r : 


:c6 = 


•~Af\r; 


:c7= 


"Ag\r 


:\ 


c8 = 


"Ah\r; 


;c9 = 


"Ai\r; 


:cA= 


"Aj\r: 


;cB= 


"Ak\r 


:\ 


cC= 


"AlXr: 


:cD= 


"AmXr ; 


;cE= 


"An\r; 


;cF= 


"Ao\r 





Type of Capabilities 

All capabilities have two letter codes. For instance, the 
fact that the Concept has 'automatic margins' (i.e., an 
automatic return and linefeed when the end of a line is 
reached) is indicated by the capability am. Hence the 
description of the Concept includes am. Numeric capabili- 
ties are followed by the character '#' and then value. 
Thus CO, which indicates the number of columns the termi- 
nal has, gives the value '80' for the Concept. 

Finally, string valued capabilities, such as ce (clear to 
end of line sequence) are given by the two character code, 
an '=', and then a string ending at the next following 
':'. A delay in milliseconds may appear after the '=' in 
such a capability, and padding characters are supplied by 
the editor after the remainder of the string is sent to 
provide this delay. The delay can be either an integer, 
e.g., '20', or an integer followed by an '*', i.e., '3*'. 
A '*' indicates that the padding required is proportional 
to the number of lines affected by the operation, and the 
amount given is the per-affected-unit padding required. 
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When a '*' is specified, it is sometimes useful to give a 
delay of the form '3.5' to specify a delay per unit to 
tenths of milliseconds. 

A number of escape sequences are provided in the 
string-valued capabilities for easy encoding of characters 
there. A \E maps to an ESCAPE character, maps to a 
control-x for any appropriate x, and the sequence \n \r \t 
\b \f give a newline, return, tab, backspace and formfeed. 
Finally, characters may be given as three octal digits 
after a \, and the characters " and \ may be given as \" 
and \\. If it is necessary to place a : in a capability 
it must be escaped in octal as \072. If it is necessary 
to place a null character in a string capability it must 
be encoded as \200. The routines that deal with termcap 
use C strings, and strip the high bits of the output very 
late so that a \200 comes out as \000 would. 



Preparing Descriptions 

We now outline how to prepare descriptions of terminals. 
The most effective way to prepare a terminal description 
is by imitating the description of a similar terminal in 
termcap and to build up a description gradually, using 
partial descriptions. Be aware that a very unusual termi- 
nal may expose deficiencies in the ability of the termcap 
file to describe it. 



Basic Capabilities 

The number of columns on each line for the terminal is 
given by the co numeric capability. If the terminal is a 
CRT, then the number of lines on the screen is given by 
the li capability. If the terminal wraps around to the 
beginning of the next line when it reaches the right mar- 
gin, then it should have an am capability. If the termi- 
nal can clear its screen, then this is given by the el 
string capability. If the terminal can backspace, then it 
should have the bs capability, unless a backspace is ac- 
complished by a character other than *H in which case you 
should give this character as the be string capability. 
If it overstrikes (rather than clearing a position when a 
character is struck over) then it should have the os capa- 
bility. 
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A very important point here is that the local cursor mo- 
tions encoded in termcap are undefined at the left and top 
edges of a CRT terminal. The editor will never attempt to 
backspace around the left edge, nor will it attempt to go 
up locally off the top. The editor assumes that feeding 
off the bottom of the screen will cause the screen to 
scroll up, and the am capability tells whether the cursor 
sticks at the right edge of the screen. If the terminal 
has switch selectable automatic margins, the termcap file 
usually assumes that this is on, i.e., am. 

These capabilities suffice to describe hardcopy and 
'glass-tty' terminals. Thus the model 33 teletype is de- 
scribed as: 

t3 1 33 I tty33 : co#72 : os 

while the Lear Siegler ADM-3 is described as: 

cl|adm3|3|lsi adin3:am:bs:cl=" :li#24:co#80 



Cursor Addressing 

Cursor addressing in the terminal is described by a cm 
string capability, with printf(S)-like escapes (%x) in it. 
These substitute to encodings of the current line or 
column position, while other characters are passed through 
unchanged. If the cm string is thought of as being a 
function, then its arguments are the line and then the 
column to which motion is desired, and the % encodings 
have the following meanings: 



%d 


as in printf, 0 origin 


%2 


like %2d 


%3 


like %3d 


% 


like %c 


%+x 


adds X to value, then % 


%>xy 


if value > x adds y, no output 


%r 


reverses order of line and column, no output 


%i 


increments lines/column (for 1 origin) 


%% 


gives a single % 


%n 


exclusive-or (xor) row and column with 0140 




(DM2500) 


%B 


BCD (16*(x/10)) + (x mod 10), no output 


%d 


Reverse coding (x-2*(x mod 16)), no output 



(Delta Data) 
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Consider the HP2645, which, to get to row 3 and column 12, 
needs to be sent \E&al2c03Y padded for 6 milliseconds. 
Note that the order of the rows and columns is inverted 
here, and that the row and column are printed as two 
digits. Thus its cm capability is 'cm=6\E&%r%2c%2Y'. The 
Microterm ACT- IV needs the current row and column sent 
preceded by a 'T, with the row and column simply encoded 
in binary, 'cm="T%%'. Terminals which use need to be 
able to backspace the cursor (bs or be), and to move the 
cursor up one line on the screen (up introduced below). 
This is necessary because it is not always safe to trans- 
mit \t, \n and \r, as the system may change or discard 
them. 

A final example is the LSI ADM-3a, which uses row and 
column offset by a blank character, thus 'cm=\E=%+ %+ '. 



Cursor Motions 

If the terminal can move the cursor one position to the 
right, leaving the character at the current position un- 
changed, then this sequence should be given as nd 
(non-destructive space). If it can move the cursor up a 
line on the screen in the same column, this should be 
given as up. If the terminal has no cursor addressing 
capability, but can home the cursor (to very upper left 
corner of screen) then this can be given as ho; similarly, 
a fast way of getting to the lower left hand corner can be 
given as 11; this may involve going up with up from the 
home position, but the editor will never do this itself 
(unless 11 does) because it makes no assumption about the 
effect of moving up from the home position. 



Area Clears 

If the terminal can clear from the current position to the 
end of the line, leaving the cursor where it is, this 
should be given as ce. If the terminal can clear from the 
current position to the end of the display, then this 
should be given as cd. The editor only uses cd from the 
first column of a line. 
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Insert/Delete Line 

If the terminal can open a new blank line before the line 
where the cursor is, this should be given as al; this is 
done only from the first position of a line. The cursor 
must then appear on the newly blank line. If the terminal 
can delete the line which the cursor is on, then this 
should be given as dl; this is done only from the first 
position on the line to be deleted. If the terminal can 
scroll the screen backwards, then this can be given as sb, 
but just al suffices. If the terminal can retain display 
memory above, then the da capability should be given; if 
display memory can be retained below then db should be 
given. These let the editor understand that deleting a 
line on the screen may bring non-blank lines up from be- 
low, or that scrolling back with sb may bring down 
non-blank lines. 



Insert/Delete Character 

There are two basic kinds of intelligent terminals with 
respect to insert/delete character which can be described 
using termcap. The most common insert/delete character 
options affect only the characters on the current line and 
shift characters off the end of the line. Other termi- 
nals, such as the Concept 100 and the Perkin Elmer Owl, 
make a distinction between typed and untyped blanks on the 
screen, shifting upon an insert or delete only to an un- 
typed blank on the screen which is either eliminated, or 
expanded to two untyped blanks. 

You can find out which kind of terminal you have by clear- 
ing the screen and then typing text separated by cursor 
motions. Type abc def using local cursor motions (not 
spaces) between the abc and the def. Then position the 
cursor before the 'abc' and put the terminal in insert 
mode. If typing characters causes the rest of the line to 
shift rigidly and characters to fall off the end, then 
your terminal does not distinguish between blanks and un- 
typed positions. If the 'abc' shifts over to the 'def,' 
which then move together around the end of the current 
line and onto the next as you insert, you have the second 
type of terminal, and should give the capability in, which 
stands for 'insert null'. If your terminal does something 
different and unusual then you may have to modify the edi- 
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tor to get it to use the insert mode your terminal de- 
fines. No known terminals have an insert mode not falling 
into one of these two classes. 

The editor can handle both terminals that have an insert 
mode and terminals which send a simple sequence to open a 
blank position on the current line. Give as im the se- 
quence to get into insert mode, or give it an empty value 
if your terminal uses a sequence to insert a blank posi- 
tion. Give as ei the sequence to leave insert mode (give 
an empty value also if you gave im an empty value). Now 
give as ic any sequence needed to be sent just before 
sending the character to be inserted. Most terminals with 
a true insert mode will not give ic; terminals that send a 
sequence to open a screen position should give it here. 
(Insert mode is preferable if a terminal has both.) If 
post insert padding is needed, give this as a number of 
milliseconds in ip (a string option). Any other sequence 
which may need to be sent after an insert of a single 
character may also be given in ip. 

It is occasionally necessary to move around while in in- 
sert mode to delete characters on the same line (e.g., if 
there is a tab after the insertion position). If your 
terminal allows motion while in insert mode you can give 
the capability mi because of the way its insert mode 
works. 

Finally, you can specify delete mode by entering dm and ed 
to enter and exit delete mode, and dc to delete a single 
character while in delete mode. 



Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout 
mode, these can be given as so and se respectively. If 
there are several types of standout mode, (such as inverse 
video, blinking, or underlining), the preferred mode is 
inverse video by itself. If the code to change into or 
out of standout mode leaves one or even two blank spaces 
on the screen, as the TVI 912 and Teleray 1061 do, this is 
acceptable, and although it may confuse some programs 
slightly, it can't be helped. 
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Codes to begin underlining and end underlining can be 
given as us and ue respectively. If the terminal has a 
code to underline the current character and move the cur- 
sor one space to the right, such as the Microterm Mime, 
this can be given as ue. (If the underline code does not 
move the cursor to the right, give the code followed by a 
nondestructive space.) 

If the terminal has a way of flashing the screen to indi- 
cate an error quietly (a bell replacement) then this can 
be given as vb; it must not move the cursor. If the ter- 
minal should be placed in a different mode during open and 
visual modes of ex, this can be given as vs and ve, sent 
at the start and end of visual mode respectively. These 
can be used to change from a underline to a block cursor 
and back. 

If the terminal needs to be in a special mode when running 
a program that addresses the cursor, the codes to enter 
and exit this mode can be given as ti and te. This 
arises, for example, from terminals like the Concept with 
more than one page of memory. If the terminal has only 
memory-relative cursor addressing and not screen relative 
cursor addressing, a one screen-sized window must be fixed 
into the terminal for cursor addressing to work properly. 

If your terminal correctly generates underlined characters 
(with no special codes needed), even though it does not 
overstrike, then you should give the capability ul. If 
overstrikes are erasable with a blank, then this should be 
indicated by giving eo. 



Keypad 

If the terminal has a keypad that transmits codes when the 
keys are pressed, this information can be given. Note 
that it is not possible to handle terminals where the key- 
pad only works in local mode (this applies for example, to 
the unshifted HP 2621 keys). If the keypad can be set to 
transmit or not transmit, give these codes as ks and ke. 
Otherwise the keypad is assumed to always transmit. The 
codes sent by the left arrow, right arrow, up arrow, down 
arrow, and home keys can be given as kl, kr, ku, kd, and 
kh respectively. If there are function keys such as fO, 
fl, ...» f9, the codes they send can be given as kO, kl, 
k9. If these keys have labels other than the default 
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fO through f9, the labels can be given as 10, 11, 19. 
If there are other keys that transmit the same code as the 
terminal expects for the corresponding function, such as 
clear screen, the termcap 2 letter codes can be given in 
the ko capability, for example, ':ko=cl,ll,sf,sb:', which 
says that the terminal has clear, home down, scroll down, 
and scroll up keys that transmit the same thing as the cl, 
11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on termi- 
nals which have single character arrow keys. It is obso- 
lete but still in use in version 2.0 of vi, which must be 
run on some minicomputers due to memory limitations. This 
field is redundant with kl, kr, ku, kd, and kh. It con- 
sists of groups of two characters. In each group, the 
first character is what an arrow key sends, the second 
character is the corresponding vi command. These command; 
are h for kl, j for kd, k for ku, 1 for kr, and H for kh. 
For example, the mime would be :ma="Kj"k"Xl; indicating 
arrow keys left ("H), down ("K), up ("), and right ("X). 
(There is no home key on the mime.) 



Miscellaneous 

If the terminal requires other than a null (zero) charac- 
ter as a pad, then this can be given as pc. 

If tabs on the terminal require padding, or if the termi- 
nal uses a character other than 'I to tab, then this can 
be given as ta. 

Hazeltine terminals, which don't allow characters to 
be printed should indicate hz. Datamedia terminals, which 
echo carriage-return linefeed for carriage return and then 
ignore a following linefeed should indicate no. Early 
Concept terminals, which ignore a linefeed immediately 
after an am wrap, should indicate xn. If an erase-eol is 
required to get rid of standout (instead of merely writing 
on top of it), xs should be given. Teleray terminals, 
where tabs turn all characters moved over to blanks, 
should indicate xt. Other specific terminal problems may 
be corrected by adding more capabilities of the form xz. 
Other capabilities include is, an initialization string 
for the terminal, and if, the name of a file containing 
long initialization strings. These strings are expected 
to properly clear and then set the tabs on the terminal, 
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if the terminal has settable tabs. If both are given, is 
will be printed before if. This is useful where if is 
/usr/lib/tabset/atd, but is clears the tabs first. 



Similar Terminals 

If there are two very similar terminals, one can be de- 
fined as being just like the other with certain excep- 
tions. The string capability tc can be given with the 
name of the similar terminal. This capability must be 
last and the combined length of the two entries must not 
exceed 1024. Since termlib routines search the entry from 
left to right, and since the tc capability is replaced by 
the corresponding entry, the capabilities given at the 
left override the ones in the similar terminal. A capa- 
bility can be cancelled with xx@, where xx is the capabil- 
ity. For example: 

hh 1 2621nl:ks@:ke@:tc=2621 : 

This defines a 262 Inl that does not have the ks or ke cap- 
abilities, and hence does not turn on the function key 
labels when in visual mode. This is useful for different 
modes for a terminal, or for different user preferences. 



Files 

/etc/termcap File containing terminal descriptions. 



Related Commands 

ex(C), tset(C), more(C) 



Credit 

This utility was developed at the University of California 
at Berkeley and is used with permission. 
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Notes 

Use of term(M) is preferred. 

Ex(C) allows only 256 characters for string capabilities, 
and the routines in termcap do not check for overflow of 
this buffer. The total length of a single entry 
(excluding only escaped newlines) may not exceed 1024. 

The ma, vs, and ve entries are specific to the vi(C) pro- 
gram. 

Not all programs support all entries. There are entries 
that are not supported by any program. 
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Name 

terminals - Supported terminals. 



Description 

The /etc/termcap file and the /usr/lib/terminfo directory 
contain two types of descriptions: terminals that have 
been tested and are supported by Altos, and terminals that 
are supplied for information only. The corresponding 
names can be used to assign the terminal type to TERM 
(see environ(M)). 

If you wish to add a terminal from the "information only" 
section of one of the terminfo files, choose a description 
that closely resembles the terminal you are adding. Put 
the terminal description in a file, and edit it to suit 
your needs. Use tic(C) to compile the file by typing the 
following: 

tic filename 



Files 

/etc/termcap 
/usr/lib/terminfo/* /■ 
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Name 

terminfo - Terminal capability database. 



Syntax 

/usr/lib/terminfo/*/* 



Description 

Terminfo is a database describing terminals, used, for 
example, by curses(S). Terminals are described in 
terminfo by giving a set of capabilities that they have, 
and by describing how operations are performed. Padding 
requirements and initialization sequences are included. 

Entries in terminfo consist of a number of comma-separated 
fields. White space after each comma (,) is ignored. The 
first entry for each terminal gives the names which are 
known for the terminal, separated by vertical bar ( | ) 
characters. The first name given is the most common ab- 
breviation for the terminal, the last name given should be 
a long name fully identifying the terminal, and all others 
are understood as synonyms for the terminal name. All 
names but the last should be in lower case and contain no 
blanks, the last name may well contain upper case and 
blanks for readability. 

Terminal names (except for the last, verbose entry) should 
be chosen using the following conventions. The particular 
piece of hardware making up the terminal should have a 
root name chosen, thus alt3 for the Altos III terminal. 
This name should not contain hyphens, except that synonyms 
may be chosen that do not conflict with other names. 
Modes that the hardware can be in, or user preferences, 
should be indicated by appending a hyphen and an indicator 
of the mode. Thus, a vtlOO in 132 column mode would be 
vtlOO-w. The following suffixes should be used where pos- 
sible; 
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Suffix Meaning Example 



-w 


Wide mode (more than 80 columns) 


vtlOO-w 


-am 


With auto, margins (usually default) 


vtlOO-am 


-nam 


Without automatic margins 


vtlOO-nam 


-n 


Number of lines on the screen 


aaa-60 


-na 


No arrow keys (leave them in local) 


clOO-na 


-np 


Number of pages of memory 


cl00-4p 


-rv 


Reverse video 


clOO-rv 



Capabilities 

The variable is the name by which the programmer (at the 
terminfo level) accesses the capability. The capname is 
the short name used in the text of the database, and is 
used by a person updating the database. The i.code is the 
two letter internal code used in the compiled database, 
and always corresponds to the old termcap(M) capability 
name. 

Capability names have no hard length limit, but an in- 
formal limit of five characters has been adopted to keep 
them short and to allow the tabs in the source file caps 
to line up nicely. Whenever possible, names are chosen to 
be the same as or similar to the ANSI X3. 64-1979 standard. 
Semantics are also intended to match those of the specifi- 
cation. 

(P) indicates that padding may be specified 

(G) indicates that the string is passed through tparm 
with parms as given (#i) 

(*) indicates that padding may be based on the number of 
lines affected 

indicates the ith parameter 
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Variable Cap- Tertncap 

name Code Description 



Booleans : 



auto left margin. 


bw 


bw 


cubl wraps from column 0 to last column 


auto_r ight_margin , 


am 


am 


Terminal has automatic margins 


beehive_glitch. 


xsb 


xb 


Beehive (fl^escape, f2=ctrl C) 


ceol standout glitch. 


xhp 


xs 


Standout (not erased by overwriting (hp) 


eat newline_glitch. 


xenl 


xn 


newline ignored after 80 cols (Concept) 


erase overstrike. 


eo 


eo 


Can erase overstrikes with a blank 


generic_type. 


gn 


gn 


Generic line type (e.g., dialup, switch) 


hard_copy , 


he 


he 


Hardcopy terminal 


has_meta_key. 


km 


km 


Has a meta key (shift, sets parity bit) 


has status_line. 


hs 


hs 


Has extra "status line" 


insert_null_glitch. 


in 


in 


Insert mode distinguishes nulls 


memory_above , 


da 


da 


Display may be retained above the screen 


memory below. 


db 


db 


Display may be retained below the screen 


move insert mode. 


mir 


mi 


Safe to move while in insert modes 


move_standout_mode. 


msgr 


ms 


Safe to move in standout modes 


over strike. 


OS 


OS 


Terminal overstrikes 


status_line_esc_ok. 


eslok 


es 


Escape can be used on the status line 


teleray glitch. 


xt 


xt 


Tabs ruin, magic so char (Teleray 1061) 


tilde_glitch. 


hz 


hz 


Hazeltine; cannot print "'s 


transparent_underline. 


ul 


ul 


Underline character overstrikes 


xon xoff. 


xon 


xo 


Terminal uses xon/xoff handshaking 



Numbers : 



column. 


cols 


CO 


Number of columns in a line 


init_tabs. 


it 


it 


Tabs initially every # spaces 


lines , 


lines 


li 


Number of lines on screen or page 


lines_of_memory. 


Im 


Im 


Lines of memory if > lines. 0 means varies 


magic_ccokie_glitch. 


xmc 


sg 


Number of blank chars left by smso or rmso 


padding_baud_rate , 


pb 


pb 


Lowest baud where cr/nl padding is needed 


virtual_terminal . 


vt 


vt 


Virtual terminal number (UNIX system) 


width status line. 


wsl 


ws 


No. columns in status line 
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Variable Cap- Termcap 

name Code Description 



Strings : 



Hcs chars 






Graphic char set pairs aAbBcC — def = vtlOO+ 


back tab. 


cbt 


bt 


oacK T,aD ( ^ 


bell , 


bel 


bl 


Audible signal (bell) (P) 


carriage return. 


cr 


cr 


Carriage return (P*) 


change scroll region. 


csr 


cs 


Change to lines #1 through #2 (vtlOO) (PC) 


clear all tabs. 


tbc 


ct 


Clear all tab stops (P) 


clear screen. 


clear 


cl 


Clear screen and home cursor (P*) 


clr eol , 


el 


ce 


Clear to end of line (P) 


clr_eos , 


ed 


cd 


Clear to end of display (P*) 


column address. 


hpa 


ch 


Set cursor column (PG) 


command character. 


cmdch 


CC 


Term. settable cmd char in prototype 


cursor address. 


cup 


cm 


Screen rel . cursor motion row #1 col #2 (PG) 


cursor down. 


cudl 


do 


Down one line 


cursor home 


home 


ho 


Home cursor (if no cup) 


cursor invisible. 


civis 


vi 


Make cursor invisible 


cursor left. 


cubl 


le 


Move cursor left one space 


cursor mem address. 


mrcup 


CM 


Memory relative cursor addressing 


cursor normal. 


cnorm 


ve 


Make cursor appear normal (undo vs/vi) 


cursor right , 


cuf 1 


nd 


Non-destructive space (cursor right) 


cursor to 11, 


11 


11 


Last line, first column (if no cup) 


cursor up. 


cuul 


up 


Upline (cursor up) 


cursor visible. 


cvvis 


vs 


Make cursor very visible 


delete character. 




dc 


Delete character (P*) 


delete line. 


dll 


dl 




dis_status_line. 


dsl 


ds 


Disable status line 


down_half_line. 


hd 


hd 


Half -line down (forward 1/2 linefeed) 


enter alt charset mode. 


smacs 


as 


Start alternate character set (P) 


enter_blink_mode. 


blink 


mb 


Turn on blinking 


enter_bold_mode. 


bold 


md 


Turn on bold (extra bright) mode 


enter ca mode. 


smcup 


ti 


String to begin programs that use cup 


enter delete mode. 


smdc 


dm 


Delete mode (enter) 


enter dim mode. 


dim 


mh 


Turn on half-bright mode 


enter insert mode. 


smir 


im 


Insert mode (enter) 


enter protected mode. 


prot 


mp 


Turn on protected mode 


enter reverse mode. 


rev 


mr 


Turn on reverse video mode 


enter secure mode. 


invis 


mk 


Turn on blank mode (chars invisible) 


enter standout_mode. 


smso 


so 


Begin stand out mode 


enter underline mode. 


smul 


us 


Start underscore mode 
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Variable Cap- Termcap 

name Code Description 



erase_chars 


ech 


ec 


exit_alt charset mode. 


rmacs 


ae 


exit_attribute_mode. 


sgrO 


me 


exit_ca mode. 


rmcup 


te 


exit_delete mode. 


rmdc 


ed 


exit_insert_mode. 


rmir 


ei 


exit_3tandout_mode. 


rmso 


se 


exit_underline_mode. 


rmul 


ue 


f lash_screen , 


flash 


vb 


form feed. 


ff 


ff 


from_status line. 


fsl 


fs 


init_lstring. 


isl 


il 


init_2string. 


is2 


i2 


init_3string. 


is3 


i3 


init_file. 


if 


if 


insert_character. 


ichl 


ic 


in3ert_line. 


ill 


al 


in3ert_padding , 


ip 


ip 


key_backspace. 


kbs 


kb 


liey_catab. 


ktbc 


ka 


key_clear. 


kclr 


kC 


key_ctab. 


kctab 


kt 


key_dc , 


kdchl 


kD 


key_dl . 


kdll 


kL 


key_down. 


kcudl 


kd 


key_eic . 


krroir 


kM 


key_eol . 


kel 


kE 


key_eos , 


ked 


kS 


keyfO 


kfO 


kO 


key_f 1 . 


kfl 


kl 


key_flO, 


kflO 


ka 


key_f2. 


kf2 


k2 


key_f 3 , 


kf3 


k3 


key_f4. 


kf4 


k4 


key_f 5 , 


kf5 


k5 


key_f6. 


kf6 


k6 


key_f7. 


kf7 


k7 


keyfS, 


kf8 


k8 


key_f 9 , 


kf9 


k9 



Erase #1 characters (PG) 

End alternate character set (P) 

Turn off all attributes 

String to end programs that use cup 

End delete mode 

End insert mode 

End stand out mode 

End underscore mode 

Visible bell (may not move cursor) 

Hardcopy terminal page eject (P*) 

Return from status line 

Terminal initialization string 

Terminal initialization string 

Terminal initialization string 

Name of file containing is 

Insert character (P) 

Add new blank line (P*) 

Insert pad after character inserted (P*) 



Sent 


by 


backspace key 


Sent 


by 


clear-all-tabs key 


Sent 


by 


clear screen or erase key 


Sent 


by 


clear-tab key 


Sent 


by 


delete character key 


Sent 


by 


delete line key 


Sent 


by 


terminal down arrow key 


Sent 


by 


rmir or smir in insert mode 


Sent 


by 


clear-to-end-of -line key 


Sent 


by 


clear-to-end-of-screen key 


Sent 


by 


function key fO 


Sent 


by 


function key fl 


Sent 


by 


function key flO 


Sent 


by 


function key f2 


Sent 


by 


function key f3 


Sent 


by 


function key f4 


Sent 


by 


function key f5 


Sent 


by 


function key f6 


Sent 


by 


function key f? 


Sent 


by 


function key f8 


Sent 


by 


function key f9 



5 



TERMINFO(M) 



TERMINFO(M) 



Variable Cap- Termcap 

name Code Description 



key_home , 


khome 


kh 


key_ic , 


kichl 


kl 


key_il. 


kill 


kA 


key_lef t , 


kcubl 


kl 


keyll , 


kll 


kH 


key npage. 


knp 


kN 


key_ppage. 


kpp 


kP 


key_right . 


kcufl 


kr 


key_sf . 


kind 


kF 


key_sr. 


kri 


kR 


key stab. 


khts 


kT 


key_up , 


kcuul 


ku 


keypad local. 


rmkx 


ke 


keypad_xniit , 


smkx 


ks 


lab_f 0, 


If 0 


10 


lab_f 1 , 


If 1 


11 


lab_f 10 , 


If 10 


la 


lab f2. 


If 2 


12 


lab_f 3 , 


If 3 


13 


,lab_f 4 , 


If 4 


14 


lab f 5 , 


If 5 


15 


lab_f 6 , 


If 6 


16 


3 _ ' 


If 7 


17 


lab f 8 , 




18 


lab_f9. 


If 9 




itieta on. 






met a off. 






newline. 


nel 


nw 


pad_char , 


pad 


pc 


parm_dch , 


dch 


DC 


parm_delete_line. 


dl 


DL 


parm down cursor. 


cud 


DO 


parm_ich , 


ich 


IC 


parm_index. 


indn 


SF 


parm_insert_line 


il 


AL 


parm_lef t_cursor. 


cub 


LE 


pann_r ight_cursor , 


cuf 


RI 


parm_rindex. 


rin 


SR 


parm_up_cursor , 


cuu 


UP 



Sent 


by 


home key 


Sent 


by 


ins char/enter ins mode key 


Sent 


by 


insert line 


Sent 


by 


terminal left arrow key 


Sent 


by 


home- down key 


Sent 


by 


next -page key 


Sent 


by 


previous-page key 


Sent 


by 


terminal right arrow key 


Sent 


by 


scroll -forward/down key 


Sent 


by 


scroll-backward/up key 


Sent 


by 


set-tab key 


Sent 


by 


terminal up arrow key 


Out of ' 


"keypad transmit" mode 



Put terminal in "keypad transmit" mode 
Labels on function key fO if not fO 
Labels on function key fl if not fl 
Labels on function key flO if not flO 
Labels on function key f2 if not f2 
Labels on function key f3 if not f3 
Labels on function key f4 if not f4 
Labels on function key f5 if not f5 
Labels on function key f6 if not f6 
Labels on function key f7 if not f7 
Labels on function key f8 if not f8 
Labels on function key f9 if not f9 
Turn on "meta mode" (8th bit) 
Turn off "meta mode" 

Newline (behaves like cr followed by If) 

Pad character (rather than null) 

Delete #1 chars (PG*) 

Delete #1 lines (PG*) 

Move cursor down #1 lines (PG*) 

Insert #1 blank chars (PG*) 

Scroll forward #1 lines (PG) 

Add #1 new blank lines (PG*) 

Move cursor left #1 spaces (PG) 

Move cursor right #1 spaces (PG*) 

Scroll backward #1 lines (PG) 

Move cursor up #1 lines (PG*) 
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Variable Cap- Termcap 

name Code Description 



pkey_key , 


pf key 


pk 


Prog funct key #1 to type string #2 


pkey_local. 


pf loc 


pl 


Prog funct key #1 to execute string #2 


pkey_xmit , 


pfx 


px 


Prog funct key #1 to xitiit string #2 


print_screen. 


mcO 


ps 


Print contents of the screen 


prtr_of f , 


mc4 


pf 


Turn off the printer 


prtr_on. 


mc5 


po 


turn on the printer 


repeat_char , 


rep 


rp 


Repeat char #1 #2 times (PG*) 


reset_lstring. 


rsl 


rl 


Reset terminal completely to sane modes 


reset 2string, 


rs2 


r2 


Reset terminal completely to sane modes 


reset_3string , 


rs3 


r3 


Reset terminal completely to sane modes 


reset_f ile. 


rf 


rf 


Name of file containing reset string 


restor_cursor. 


rc 


rc 


Restore cursor to position of last sc 


row_address . 


vpa 


cv 


Vertical position absolute (set row) (PG) 


save cursor. 


sc 


sc 


Save cursor position (P) 


scroll_forward. 


ind 


sf 


Scroll text up (P) 


scroll_reverse , 


ri 


sr 


Scroll text down (P) 


set_attributes. 


sgr 


sa 


Define the video attributes (PG9) 


set_tab , 


hts 


St 


Set a tab in all rows, current column 


set_window. 


wind 


wi 


Current window is lines #l-#2 cols #3-#4 


tab. 


ht 


ta 


Tab to next 8 space hardware tab stop 


to 3tatus_line, 


tsl 


ts 


Go to status line, column #1 


underline_char , 


uc 


uc 


Underscore one char and move past it 


up_halC_line, 


hu 


hu 


Half-line up (reverse 1/2 linefeed) 


init_prog. 


iprog 


iP 


Path name of program for init 


key_al , 


kal 


Kl 


Upper left of keypad 


key_a3 , 


ka3 


K3 


Upper right of keypad 


key_b2 , 


kb2 


K2 


Center of keypad 


key_cl , 


kcl 


K4 


Lower left of keypad 


key_c3 , 


kc3 


K5 


Lower right of keypad 


prtr_non 


mcSp 


po 


Turn on the printer for #1 bytes 
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A Sample Entry 

The following is a complex example that describes a 
Concept- 100. 

conceptlOO | clOO | cl04 | cl00-4p | concept 100 , 

am, bel="G, blank=\EH, blink=\EC, clear= 'L$<2*> , cnorm=\Ew, 
cols#80, cr="M$<9>, cubl="H, cudl=-J, cufl=\E=, 
cup=\Ea%pl%' '%+%c%p2%' ■%+%c, 

cuul=\E;, cvvis=\EW, db, dchl=\E'A$<16*> , dim=\EE; , dll=E"B$<3* > , 
ed=\E'C$<16*>, el=\E'U$<16> , eo, f lash=\EK$< 20>\EK, ht=\t$<8>, 
ill=\E"R$<3*>, in, ind=*J, .ind="J$<9>, ip=$<16*>, 
is2=\EU\Ef \E7\E5\E8\El\ENH\EK\E\200\Eo&\200\Eo\4 7\E, 
kbs="h. kcubl=\E>, kcudl=\E<, kcufl=\E=, kcuul=\E; , 
kfl=\E5, kf2=\E6, kf3=\E7, khome=\E?, 

lines#24, mir, pb#9600, prot=\EI, rep=\Er%pl%c%p2% ' '%+%c$<.2*>, 
rev=\ED, rmcup=\EV $<6>\Ep\r\n, rmir=\E\200 , rmkx=\Ex, 
rmso=\Ed\Ee, rmul=\Eg, rmul=\Eg, sgrO=\EN\200 , 
smcup=\EU\Ev 8p\Ep\r, smir=\E"P, smkx=\EX, smso=\EE\ED, 
smul=\EG, tabs, ul, vt#8, xenl , 

Entries may continue onto multiple lines by placing white 
space at the beginning of each line except the first. 
Comments may be included on lines beginning with a 

Capabilities in terminfo are of three types: Boolean cap- 
abilities which indicate that the terminal has some par- 
ticular feature, numeric capabilities giving the size of 
the terminal or the size of particular delays, and string 
capabilities, which give a sequence that can be used to 
perform particular terminal operations. 



Types of Capabilities 

All capabilities have names. For instance, the Concept- 
lOO has automatic margins (i.e., an automatic return and 
linefeed when the end of a line is reached) which is in- 
dicated by the capability am. Numeric capabilities are 
followed by the character # and then the value. Thus, 
cols, which indicates the number of columns the terminal 
has, gives the value 80 for the Concept. 

Finally, string valued capabilities, such as el (clear to 
end of line sequence) are given by the two-character code, 
an =, and then a string ending at the next following ,. A 
delay in milliseconds may appear anywhere in such a capa- 
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bility, enclosed in $<..> brackets, as in el=\EK$<3>, and 
padding characters are supplied by tputs to provide this 
delay. The delay can be either a number, e.g., 20, or a 
number followed by an *, i.e., 3*. A * indicates that the 
padding required is proportional to the number of lines 
affected by the operation, and the amount given is the 
peraffected-unit padding required. (In the case of insert 
character, the factor is still the number of lines af- 
fected. This is always one unless the terminal has xenl 
and the software uses it.) When a * is specified, it is 
sometimes useful to give a delay of the form 3.5 to speci- 
fy a delay per unit to tenths of milliseconds. (Only one 
decimal place is allowed.) 

A number of escape sequences are provided in the string 
valued capabilities for each encoding of characters there. 
Both \E and \e map to an ESCAPE character, maps to a 
control-x for any appropriate x, and the sequences \n \1 
\r \t \b \f \s give a newline, linefeed, return, tab, 
backspace, formfeed, and space. Other escapes include \" 
for \\ for \, \, for comma, \: for :, and \0 for null. 
(\0 will produce \200, which does not terminate a string 
but behaves as a null character on most terminals.) 

Sometimes individual capabilities must be commented out. 
To do this, put a period before the capability name. 



Preparing Terminal Descriptions 

The most effective way to prepare a terminal description 
is by imitating the description of a similar terminal in 
terminfo and to build up a description gradually, using 
partial descriptions with vi(C) to check that they are 
correct. Be aware that a very unusual terminal may expose 
deficiencies in the ability of the terminfo file to de- 
scribe it or bugs in vi. To easily test a new terminal 
description you can set the environment variable TERMINFO 
to a pathname of a directory containing the compiled de- 
scription you are working on and programs will look there 
rather than in /usr/lib/terminfo. To get the padding for 
insert line right (if the terminal manufacturer did not 
document it) a severe test is to edit a test file at 9600 
baud, delete 16 or so lines (i.e., dl6d) from the middle 
of the screen, then press the u key several times quickly. 
If the terminal messes up, more padding is usually needed. 
A similar test can be used for insert character. 
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Basic Capabilities 

The number of columns on each line for the terminal is 
given by the cols numeric capability. If the terminal is 
a CRT, then the number of lines on the screen is given by 
the lines capability. If the terminal wraps around to the 
beginning of the next line when it reaches the right mar- 
gin, then it should have the am capability. If the ter- 
minal can clear its screen, leaving the cursor in the home 
position, then this is given by the clear string capabili- 
ty. If the terminal overstrikes (rather than clearing a 
position when a character is struck over) then it should 
have the os capability. If the terminal is a printing 
terminal, with no soft copy unit, give it both he and os. 
(os applies to storage scope terminals, such as TEKTRONIX 
4010 series, as well as hardcopy and APL terminals.) If 
there is a code to move the cursor to the left edge of the 
current row, give this as cr. (Normally this will be car- 
riage return, control M.) If there is a code to produce an 
audible signal (bell, beep, etc.) give this as bel. 

If there is a code to move the cursor one position to the 
left (such as backspace) that capability should be given 
as cubl. Similarly, codes to move to the right, up, and 
down should be given as cufl, cuul, and cudl. These local 
cursor motions should not alter the text they pass over, 
for example, you would not normally use 'cufl=' because 
the space would erase the character moved over. 

A very important point here is that the local cursor mo- 
tions encoded in terminfo are undefined at the left and 
top edges of a CRT terminal. Programs should never at- 
tempt to backspace around the left edge, unless bw is 
given, and never attempt to go up locally off the top. In 
order to scroll text up, a program will go to the bottom 
left corner of the screen and send the ind (index) string. 

To scroll text down, a program goes to the top left corner 
of the screen and sends the ri (reverse index) string. 
The strings ind and ri are undefined when not on their 
respective corners of the screen. 

Parameterized versions of the scrolling sequences are indn 
and ri except that they take one parameter, and scroll 
that many lines. They are also undefined except at the 
appropriate edge of the screen. 
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The am capability tells whether the cursor sticks at the 
right edge of the screen when text is output, but this 
does not necessarily apply to a cufl from the last column. 
The only local motion which is defined from the left edge 
is if bw is given, then a cubl from the left edge will 
move to the right edge of the previous row. If bw is not 
given, the effect is undefined. This is useful for draw- 
ing a box around the edge of the screen, for example. 

If the terminal has switch selectable automatic margins, 
the terminfo file usually assumes that this is on; i.e., 
am. If the terminal has a command which moves to the 
first column of the next line, that command can be given 
as nel (newline). It does not matter if the command 
clears the remainder of the current line, so if the ter- 
minal has no or and If it may still be possible to craft a 
working nel out of one or both of them. 

These capabilities suffice to describe hardcopy and 
glass-tty terminals. Thus the model 33 teletype is de- 
scribed as: 

33|tty33|model 33 teletype, 

bel="G, cols#72, cr=~M, cudl="J, he, ind="J, os, 

while the Lear Siegler ADM-3 is described as: 

adm3 1 3 1 Isi adin3 , 

am, bel="G, clear=", cols#80, cr="M, cubl="H, cudl="J, 
ind="J, lines#24. 

Parameterized Strings 

Cursor addressing and other strings requiring parameters 
in the terminal are described by a parameterized string 
capability, with prinf(S) like escapes %x in it. For ex- 
ample, to address the cursor, the cup capability is given, 
using two parameters: the row and column to address to. 
(Rows and columns are numbered from zero and refer to the 
physical screen visible to the user, not to any unseen 
memory.) If the terminal has memory relative cursor ad- 
dressing, that can be indicated by mrcup. 

The parameter mechanism uses a stack and special % codes 
to manipulate it. Typically a sequence will push one of 
the parameters onto the stack and then print it in some 
format. Often more complex operations are necessary. 
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The % encodings have the following meanings: 



U outputs 

%d print popO as in printf 

%2d print popO like %2d 

%3d print popO like %3d 

%02d 

W3d as in printf 

%c print popO as %c 

%s print popO as %s 

%p[l-9] push ith parm 

%P[a-z] set variable [a-z] to popO 

%g[a-z] get variable [a-z] and push it 

%'c' char constant c 

%{nn} integer constant nn 

%+%-%*%/%m 

arithmetic {%m is mod): push(pop() op popO) 

bit operations: push(pop() op popO) 
logical operations: push(pop() op 
popO) 

unary operations push(op popO) 
%i add 1 to first two parms (for ANSI 

terminals) 



%? expr %t thenpart %e elsepart %; 

if-then-else, %e elsepart is optional, 
else-if's are possible ala Algol 68: 
%? cl %tbl %ec2 %tb2 %ec3 %tb3 %ec4 

%tb4 %e%; 
ci are conditions, bi are bodies. 

Binary operations are in postfix form with the operands in 
the usual order. That is, to get x-5 one would use 
%gx%{5}%-. 

Consider the HP2645, which, to get to row 3 and column 12, 
needs to be sent \E%&al2c03Y padded for six milliseconds. 
Note that the order of the rows and columns is inverted 
here, and that the row and column are printed as two 
digits. Thus its cup capability is cup=6\E&%p2%2dc%pl%2dY. 

The Microterm ACT- IV needs the current row and column 
sent preceded by a "T, with the row and column simply en- 
coded in binary, cup="T%pl%c%p2%c. Terminals which use %c 
need to be able to backspace the cursor (cubl), and to 
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move the cursor up one line on the screen (cuul). This is 
necessary because it is not always safe to transmit \n 
and \r, as the system may change or discard them. (The 
library routines dealing with terminfo set tty modes so 
that tabs are never expanded, so \t is safe to send. This 
turns out to be essential for the Ann Arbor 4080.) 

A final example is the LSI ADM-3a, which uses row and 
column offset by a blank character, thus cup=\E=%pl%' 
'%+%c%p2%' '%+%c. After sending '\E=', this pushes the 
first parameter, pushes the ASCII value for a space (32), 
adds them (pushing the sum on the stack in place of the 
two previous values) and outputs that value as a charac- 
ter. Then the same is done for the second parameter. 
More complex arithmetic is possible using the stack. 

If the terminal has row or column absolute cursor addres- 
sing, these can be given as single parameter capabilities 
•hpa (horizontal position absolute) and vpa (vertical posi- 
tion absolute). Sometimes these are shorter than the more 
general two parameter sequence (as with the hp2645) and 
can be used in preference to cup. If there are parameter- 
ized local motions (e.g., move n spaces to the right) 
these can be given as cud, cub, cuf, and cuu with a single 
parameter indicating how many spaces to move. These are 
primarily useful if the terminal does not have cup, such 
as the TEKTRONIX 4025. 



Cursor Motions 

If the terminal has a fast way to home the cursor (to the 
very upper left corner of screen) then this can be given 
as home; similarly a fast way of getting to the lower 
left-hand corner can be given as 11; this may involve go- 
ing up with cuul from the home position, but a program 
should never do this itself (unless 11 does) because it 
can make no assumption about the effect of moving up from 
the home position. Note that the home position is the 
same as addressing to (0,0): to the top left corner of 
the screen, not of memory. (Thus, the \EH sequence on HF 
terminals cannot be used for home.) 
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Area Clears 

If the terminal can clear from the current position to the 
end of the line, leaving the cursor where it is, this 
should be given as el. If the terminal can clear from the 
current position to the end of the display, then this 
should be given as ed. Ed is only defined from the first 
column of a line. (Thus, it can be simulated by a request 
to delete a large number of lines, if a true ed(C) is not 
available. ) 



Insert/Delete Line 

If the terminal can open a new blank line before the line 
where the cursor is, this should be given as ill; this is 
done only from the first position of a line. The cursor 
must then appear on the newly blank line. If the terminal 
can delete the line which the cursor is on, then this 
should be given as dll; this is done only from the first 
position on the line to be deleted. Versions of ill and 
dll which take a single parameter and insert or delete 
that many lines can be given as 11 and dl. If the termi- 
nal has a settable scrolling region (like the vtlOO) the 
command to set this can be described with the csr capabil- 
ity, which takes two parameters: the top and bottom lines 
of the scrolling region. The cursor position is, alas, 
undefined after using this conmiand. It is possible to get 
the effect of insert or delete line using this command ~ 
the so and re (save and restore cursor) commands are also 
useful. Inserting lines at the top or bottom of the 
screen can also be done using ri or ind on many terminals 
without a true insert/delete line, and is often faster 
even on terminals with those features. 

If the terminal has the ability to define a window as part 
of memory, which all commands affect, it should be given 
as the parameterized string wind. The four parameters are 
the starting and ending lines in memory and the starting 
and ending columns in memory, in that order. 

If the terminal can retain display memory above, then the 
da capability should be given; if display memory can be 
retained below, then db should be given. These indicate 
that deleting a line or scrolling may bring non-blank 
lines up from below or that scrolling back with ri may 
bring down non-blank lines. 
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Insert/Delete Character 

There are two basic kinds of intelligent terminals with 
respect to insert/delete character which can be described 
using terminfo. The most common insert/delete character 
operations affect only the characters on the current line 
and shift characters off the end of the line rigidly. 
Other terminals, such as the Concept 100 and the Perkin 
Elmer Owl, make a distinction between typed and untj^ed 
blanks on the screen, shifting upon an insert or delete 
only to an untjTped blank on the screen which is either 
eliminated, or expanded to two untyped blanks. 

You can determine the kind of terminal you have by clear- 
ing the screen and then typing text separated by cursor 
motions. Type abc def using local cursor motions (not 
spaces) between the abc and the def. Then position the 
cursor before the abc and put the terminal in insert mode. 
If typing characters causes the rest of the line to shift 
rigidly and characters to fall off the end, then your ter- 
minal does not distinguish between blanks and untyped po- 
sitions. If the abc shifts over to the def which then 
move together around the end of the current line and onto 
the next as you insert, you have the second type of ter- 
minal, and should give the capability in, which stands for 
insert null. While these are two logically separate at- 
tributes (one line vs. multiline insert mode, and special 
treatment of untyped spaces), no known terminals have an 
insert mode that cannot be described with the single at- 
tribute. 

Terminfo can describe both terminals which have an insert 
mode, and terminals which send a simple sequence to open 
blank position on the current line. Give as smir the se- 
quence to get into insert mode. Give as rmir the sequence 
to leave insert mode. Now give as ichl any sequence 
needed to be sent just before sending the character to be 
inserted. Most terminals with a true insert mode will not 
give ichl; terminals which send a sequence to open a 
screen position should give it here. (If your terminal 
has both, insert mode is usually preferable to ichl. Do 
not give both unless the terminal actually requires both 
to be used in combination.) If post insert padding is 
needed, give this as a number of milliseconds in ip (a 
string option). 
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Any other sequence which may need to be sent after an in- 
sert of a single character may also be given in ip. If 
your terminal needs both to be placed into an insert mode 
and a special code to precede each inserted character, 
then both smir/rmir and ichl can be given, and both will 
be used. The ich capability, with one parameter, n, will 
repeat the effects of ichl n times. 

It is occasionally necessary to move around while in in- 
sert mode to delete characters on the same line (e.g., if 
there is a tab after the insertion position). If your 
terminal allows motion while in insert mode you can give 
the capability mir to speed up inserting in this case. 
Omitting mir will affect only speed. Some terminals 
(notably Datamedia's) must not have mir because of the way 
their insert mode works. 

Finally, you can specify dchl to delete a single charac- 
ter, dch with one parameter, n, to delete n characters, 
and delete mode by giving smdc and rmdc to enter and exit 
delete mode (any mode the terminal needs to be placed in 
for dchl to work). 

A command to erase n characters (equivalent to outputting 
n blanks without moving the cursor) can be given as ech 
with one parameter. 



Highlighting, Underlining, and Visible Bells 

If your terminal has one or more kinds of display attri- 
butes, these can be represented in a number of different 
ways. You should choose one display form as standout 
mode, representing a good, high contrast, easy-on-the- 
eyes, format for highlighting error messages and other 
attention getters. (If you have a choice, reverse video 
plus half-bright is good, or reverse video alone.) The 
sequences to enter and exit standout mode are given as 
smso and rmso, respectively. If the code to change into 
or out of standout mode leaves one or even two blank 
spaces on the screen, as the TVI 912 and Teleray 1061 do, 
then xmc should be given to tell how many spaces are left. 

Codes to begin underlining and end underlining can be 
given as smul and armul respectively. If the terminal has 
a code to underline the current character and move the 
cursor one space to the right, such as the Microterm Mime, 
this can be given as uc. 
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Other capabilities to enter various highlighting modes 
include: 



blink 


blinking 


bold 


bold or extra bright 


dim 


dim or half-bright 


invis 


blanking or invisible text 






rev 


reverse video 


sgrO 


turn off all attribute modes 


smacs 


enter alternate character set mode 


rmacs 


exit alternate character set mode 



Turning on any of these modes singly may or may not turn 
off other modes. 

If there is a sequence to set arbitrary combinations of 
modes, this should be given as sgr (set attributes), tak- 
ing 9 parameters. Each parameter is either 0 or 1, as the 
corresponding attribute is on or off. The 9 parameters 
are, in order: standout, underline, reverse, blink, dim, 
bold, blank, protect, alternate character set. Not all 
modes need be supported by sgr, only those for which cor- 
responding separate attribute commands exist. 

Terminals with the "magic cookie" glitch (xmc) deposit 
special "cookies" when they receive mode-setting se- 
quences, which affect the display algorithm rather than 
having extra bits for each character. Some terminals, 
such as the HP2621, automatically leave standout mode whei 
they move to a new line or the cursor is addressed. Pro- 
grams using standout mode should exit standout mode before 
moving the cursor or sending a newline, unless the msgr 
capability, asserting that it is safe to move in standout 
mode, is present. 

If the terminal has a way of flashing the screen to indi- 
cate an error quietly (a bell replacement) then this can 
be given as flash; it must not move the cursor. 
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If the cursor needs to be made more visible than normal 
when it is not on the bottom line (to make, for example, a 
non-blinking underline into an easier to find block or 
blinking underline) give this sequence as cwis. If there 
is a way to make the cursor completely invisible, give 
that as cvis. The capability enorm should be given, which 
undoes the effects of both of these models. 

If the terminal needs to be in a special mode when running 
a program that uses these capabilities, the codes to enter 
and exit this mode can be given as smeup and rmcup. This 
arises, for example, from terminals like the Concept with 
more than one page of memory. If the terminal has only 
memory relative cursor addressing and not screen relative 
cursor addressing, a one screen-sized window must be fixed 
into the terminal for cursor addressing to work properly. 
This is also used for the TEKTRONIX 4025, where smcup 
sets the command character to the one used by terminfo. 

If your terminal correctly generates underlined characters 
(with no special codes needed) even though it does not 
overstrike, then you should give the capability ul. If 
overstrikes are erasable with a blank, then indicate this 
by giving eo. 



Keypad 

If the terminal has a keypad that transmits codes when the 
keys are pressed, this information can be given. Note 
that it is not possible to handle terminals where the key- 
pad only works in local (this applies, for example, to the 
unshifed HP2621 keys). If the keypad can be set to trans- 
mit or not to transmit, give these codes as smkx and rmkx. 
Otherwise, the keypad is assumed to always transmit. The 
codes sent by the left arrow, right arrow, up arrow, down 
arrow, and home keys can be given as kcubl, kcufl, kcuul, 
kcudl, and khome respectively. If there are function keys 
such as fO, fl, flO, the codes they send can be given 
as kfO, kfl, kflO. If these keys have labels other 
than the default fO through flO, the labels can be given 
as IfO, Ifl, if 10. The codes transmitted by certain 
other special keys can be given: kll (home down), kbs 
(backspace), ktbc (clear all tabs), ketab (clear the tab 
stop in this column), kclr (clear screen or erase key), 
kdchl (delete character), kdll (delete line), krmir (exit 
insert mode), kel (clear to end of line), kill (insert 
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line), knp (next page), kpp (previous page), kind (scroll 
forward/down), kri (scroll backward/up), khts (set a tab 
stop in this column). In addition, if the keypad has a 3 
by 3 array of keys including the four arrow keys, the 
other five keys can be given as kal, kaS, kb2, kcl, and 
kc3. These keys are useful when the effects of a 3 by 3 
directional pad are needed. 



Tabs and Initialization 

If the terminal has hardware tabs, the command to advance 
to the next tab stop can be given as ht (usually 
control-I). A "backtab" command (move left to the next 
tab stop) can be given as cbt. By convention, if the 
teletype modes indicate that tabs are being expanded by 
the computer rather than being sent to the terminal, pro- 
grams should not use ht or cbt even if they are present, 
since the user may not have the tab stops properly set. 
If the terminal has hardware tabs which are initially set 
every n spaces when the terminal is powered up, the nu- 
meric parameter it is given, showing the number as spaces 
the tabs are set to. This is normally used by the tset(C) 
command to determine whether to set the mode for hardwar 
tab expansion, and whether to set the tab stops. If the 
terminal has tab stops that can be saved in nonvolatile 
memory, the terminfo description can assume that they are 
properly set. 

Other capabilities include isl, is2, and is3, initializa- 
tion strings for the terminal, iprog, the path name of a 
program to be run to initialize the terminal, and if, the 
name of a file containing long initialization strings. 
These strings are expected to set the terminal into modes 
consistent with the rest of the terminfo description. 
They are normally sent to the terminal by the tset(C) pro- 
gram each time the user logs in. They will be printed in 
the following order: isl; is2; setting tabs using tbc and 
hts; if; running the program iprog; and finally is3. Most 
initialization is done with is2. 

Special terminal modes can be set up without duplicating 
strings by putting the common sequences in is2 and special 
cases in isl and is3. A pair of sequences that does a 
harder reset from a totally unknown state can be analog- 
ously given as rsl, rs2, and rs3, analogous to is2 and if. 
These strings are output by the reset program, which is 
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used when the terminal gets into a wedged state. Com- 
mands are normally placed in rs2 and rf only if they pro- 
duced annoying effects on the screen and are not necessary 
when logging in. For example, the command to set the 
vtlOO into 80-column mode would normally be part of is2, 
but it causes an annoying glitch of the screen and is not 
normally needed since the terminal is usually already in 
80 column mode. 

If there are commands to set and clear tab stops, they can 
be given as tbc (clear all tab stops) and hts (set a tab 
stop in the current column of every row). If a more com- 
plex sequence is needed to set the tabs than can be de- 
scribed by this, the sequence can be placed in is2 or if. 



Delays 

Certain capabilities control padding in the teletype driv- 
er. These are primarily needed by hardcopy terminals, and 
are used by the tset program to set teletype modes appro- 
priately. Delays embedded in the capabilities or, ind, 
cubl, ff, and tab will cause the appropriate delay bits to 
be set in the teletype driver. If pb (padding baud rate) 
is given, these values can be ignored at baud rates below 
the value of pb. 



Line Graphics 

If the terminal has a line drawing alternate character 
set, the mapping of gl3T5h to character would be given in 
acsc. The definition of this string is based on the al- 
ternate character set used in the DEC VTIOO terminal, 
extended slightly with some modifications from the AT&T 
4410vl terminal. These characters and their corresponding 
glyphs are shown in the following table: 
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Glyph Name VT100+ Character 



arrow pointing right 


+ 


arrow pointing left 


» 


arrow pointing down 


• 


solid square block 


0 


lantern sjnnbol 


I 


arrow pointing up 


- 


diamond 




checker board (stipple) 


a 


degree symbol 


f 


plus/minus 


g 


board of squares 


h 


lower right corner 


j 


upper right corner 


k 


upper left corner 


1 


lower left corner 


m 


plus 


n 


scan line 1 


o 


horizontal line 


q 


scan line 9 


s 


left tee 


t 


right tee 


u 


bottom tee 


V 


top tee 


w 


vertical line 


X 


bullet 





The best way to describe a terminal's line graphics set is 
to add a third column to the above table with the charac- 
ters for the new terminal that produce the appropriate 
glyph when the terminal is in the alternate character set 
mode. An example is on the following page: 



21 



TERMINFO(M) 



TERMINFO(M) 



Glyph Name VT100+ New tty 

Char. Char. 



upper left corner 
lower left corner 
upper right corner 
lower right corner 
horizontal line 
vertical line 



1 R 

m F 

k T 

j G 

q 

X 



Specify the characters defining the new tty character set 
in a left-to-right order, as shown in the following ex- 
ample (taken from the example above): 

acsc=lRmFkTjGq\ ,x. 



Miscellaneous 

If the terminal requires other than a null (zero) charac- 
ter as a pad, then this can be given as pad. Only the 
first character of the pad string is used. 

If the terminal has an extra "status line" that is not 
normally used by software, this fact can be indicated. If 
the status line is viewed as an extra line below the bot- 
tom line, into which one can cursor address normally (such 
as the Heathkit hl9's 25th line, or the 24th line of a 
vtlOO which is set to a 23-line scrolling region), the 
capability hs should be given. Special strings to go to 
the beginning of the status line and to return from the 
status line can be given as tsl and fsl. (fsl must leave 
the cursor position in the same place it was before tsl. 
If necessary, the sc and rc strings can be included in tsl 
and fsl to get this effect.) The capability tsl takes one 
parameter, which is the column number of the status line 
the cursor is to be moved to. 

If escape sequences and other special commands, such as 
tab, work while in the status line, the flag eslok can be 
given. A string which turns off the status line (or 
otherwise erases its contents) should be given as dsl. If 
the terminal has commands to save and restore the position 
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of the cursor, give them as sc and rc. The status line is 
normally assumed to be the same width as the rest of the 
screen, e.g., cols. If the status line is a different 
width (possibly because the terminal does not allow an 
entire line to be loaded) the width, in columns, can be 
indicated with the numeric parameter wsl. 

If the terminal can move up or down half a line, this can 
be indicated with hu (half -line up) and hd (half -line 
down). This is primarily useful for superscripts and sub- 
scripts on hardcopy terminals. If a hardcopy terminal can 
eject to the next page (form feed), give this as ff 
(usually control L). 

If there is a command to repeat a given character a given 
number of times (to save time transmitting a large number 
of identical characters) this can be indicated with the 
parameterized string rep. The first parameter is the 
character to be repeated and the second is the number of 
times to repeat it. Thus, tparm(repeat_char, 'x', 10) is 
the same as 'xxxxxxxxxx'. 

If the terminal has a settable command character, such as 
the TEKTRONIX 4025, this can be indicated with cmdeh. A 
prototype conmiand character is chosen which is used in all 
capabilities. This character is given in the cmdeh capa- 
bility to identify it. The following convention is sup- 
ported on some UNIX systems: The environment is to be 
searched for a CC variable, and if found, all occurrences 
of the prototype character are replaced with the character 
in the environment variable. 

Terminal descriptions that do not represent a specific 
kind of known terminal, such as switch, dialup, patch, and 
network, should include the gn (generic) capability so 
that programs can complain that they do not know how to 
talk to the terminal. (This capability does not apply to 
virtual terminal descriptions for which the escape se- 
quences are known.) 

If the terminal uses xon/xoff handshaking for flow con- 
trol, give xon. Padding information should still be in- 
cluded so that routines can make better decisions about 
costs, but actual pad characters will not be transmitted. 
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If the terminal has a "meta key" that acts as a shift 
key, setting the eighth bit of any character transmitted, 
this fact can be indicated with km. Otherwise, software 
will assume that the eighth bit is parity and it will 
usually be cleared. If strings exist to turn this "meta 
mode" on and off, they can be given as smm and rmm. 

If the terminal has more lines of memory than will fit on 
the screen at once, the number of lines of memory can be 
indicated with Im. A value of lm#0 indicates that the 
number of lines is not fixed, but that there is still more 
memory than fits on the screen. 

If the. terminal is one of those supported by the UNIX 
virtual terminal protocol, the terminal number can be 
given as vt. Media copy strings which control an auxil- 
iary printer connected to the terminal can be given as 
mcO: print the contents of the screen, mc4: turn off the 
printer, and mc5: turn on the printer. When the printer 
is on, all text sent to the terminal will be sent to the 
printer. It is undefined whether the text is also dis- 
played on the terminal screen when the printer is on. A 
variation mc5p takes one parameter, and leaves the printer 
on for as many characters as the value of the parameter, 
then turns the printer off. 

The parameter should not exceed 255. All text, including 
mc4, is transparently passed to the printer while an mc5p 
is in effect. 

Strings to program function keys can be given as pfkey, 
pfloc, and pfx. Each of these strings takes two param- 
eters: the function key number to program (from 0 to 10) 
and the string to program it with. Function key numbers 
out of this range may program undefined keys in a terminal 
dependent manner. The difference between the capabilities 
is that pfkey causes pressing the given key to be the same 
as the user typing the given string; floe causes the 
string to be executed by the terminal in local; and pfx 
causes the string to be transmitted to the computer. 



Glitches and Braindamage 

Hazeltine terminals, which do not allow ~~ characters to 
be displayed should indicate hz. 
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Terminals that ignore a linefeed immediately after an am 
wrap, such as the Concept and vtlOO, should indicate xenl. 

If el is required to get rid of standout (instead of mere- 
ly writing normal text on top of it), xhp should be given. 

Teleray terminals, where tabs turn all characters moved 
over to blanks, should indicate xt (destructive tabs). 
This glitch is also taken to mean that it is not possible 
to position the cursor on top of a "magic cookie", that to 
erase standout mode it is instead necessary to use delete 
and insert line. 

The Beehive Superbee, which is unable to correctly trans- 
mit the escape or Control-C characters, has xsb, indicat- 
ing that the fl key is used for escape and f2 for 
control-C. (Only certain Superbees have this problem, 
depending on the ROM.) Other specific terminal problems 
may be corrected by adding more capabilities of the form 

XX. 



Similar Terminals 

If there are two very similar terminals, one can be de- 
fined as being just like the other with certain excep- 
tions. The string capability use can be given with the 
name of the similar terminal. The capabilities given be- 
fore use override those in the terminal type invoked by 
use. A capability can be cancelled by placing xx@ to the 
left of the capability definition, where xx is the capa- 
bility. For example, the entry 

2621-nl, sitikx@, rmkx@, use=2621, 

defines a 2621-nl that does not have the smkx or rmkx cap- 
abilities, and hence does not turn on the function key 
labels when in visual mode. This is useful for different 
modes for a terminal, or for different user preferences. 
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FUes 

/usr/lib/terminfo/?/* Files containing terminal 

descriptions 

/usr/lib/terminfo/altos.src File containing descriptions 

of terminals supported by 
Altos 

/usr/lib/terminfo/terminfo.src File, containing descriptions 

of other terminals not sup- 
ported by Altos 



See Also 

term(M) 
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Name 

termio - General terminal interface. 



Description 

All of the asynchronous communications ports use the same 
general interface, no matter what hardware is involved. 
The remainder of this section discusses the common fea- 
tures of this interface. 

When a terminal file is opened, it normally causes the 
process to wait until a connection is established. In 
practice, users' programs seldom open these files; they 
are opened by getty(M) and become a user's standard input, 
output, and error files. The very first terminal file 
opened by the process group leader of a terminal file not 
already associated with a process group becomes the con- 
trol terminal for that process group. The control termi- 
nal plays a special role in handling quit and interrupt 
signals, as discussed below. The control terminal is in- 
herited by a child process during a fork(S). A process 
can break this association by changing its process group 
using setpgrp(S). 

A terminal associated with one of these files ordinarily 
operates in full duplex mode. You can type characters at 
any time, even while output is occurring, and are only 
lost when the system's character input buffers become com- 
pletely full, which is rare, or when the user has accumu- 
lated the maximum allowed number of input characters that 
have not yet been read by some program. Currently, this 
limit is 256 characters. When the input limit is reached, 
all the saved characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. 
A line is delimited by a newline (ASCII LF) character, an 
end-of-file (ASCII EOT) character, or an end-of-line char- 
acter. This means that a program attempting to read will 
be suspended until an entire line has been typed. Also, 
no matter how many characters are requested in the read 
call, at most one line will be returned. It is not, how- 
ever, necessary to read a whole line at once; any number 
of characters may be requested in a read, even one, with- 
out losing information. 
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During input, erase and kill processing is normally done. 
By default, the character # erases the last character 
t5?ped, except that it will not erase beyond the beginning 
of the line. By default, the character @ kills (deletes) 
the entire input line, and optionally outputs a new-line 
character. Both these characters operate on a keystroke 
basis, independently of any backspacing or tabbing that 
may have been done. Both the erase and kill characters 
may be entered literally by preceding them with the escape 
character (\). In this case, the escape character is not 
read. The erase and kill characters may be changed. 

Certain characters have special functions on input. These 
functions and their default character values are summar- 
ized as follows: 

INTR (Rubout or ASCII DEL) generates an interrupt 
signal which is sent to all processes with the 
associated control terminal. Normally, each 
such process is forced to terminate, but ar- 
rangements may be made either to ignore the sig- 
nal or to receive a trap to an agreed-upon loca- 
tion; see signal(S). 

QUIT (Control-\ or ASCII FS) generates a quit signal. 

Its treatment is identical to the interrupt sig- 
nal except that, unless a receiving process has 
made other arrangements, it will not only be 
terminated but a core image file (called core) 
will be created in the current working direc- 
tory. 

ERASE (#) erases the preceding character. It will not 
erase beyond the start of a line, as delimited 
by a NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a 

NL, EOF, or EOL character. 

EOF (Control-d or ASCII EOT) may be used to gener- 

ate an end-of-file from a terminal. When re- 
ceived, all the characters waiting to be read 
are immediately passed to the program, without 
waiting for a newline, and the EOF is discarded. 
Thus, if there are no characters waiting, which 
is to say the EOF occurred at the beginning of a 
line, zero characters will be passed back, which 
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is the standard end-of-file indication. NL 
(ASCII LF) is the normal line delimiter. It 
cannot be changed or escaped. 

EOL (ASCII NUL) is an additional line delimiter, 

like NL. It is not normally used. 

STOP (Control-s or ASCII DC3) can be used to tempo- 
rarily suspend output. It is useful with CRT 
terminals to prevent output from disappearing 
before it can be read. While output is sus- 
pended, STOP characters are ignored and not 
read. 

START (Control-q or ASCII DCl) is used to resume out- 
put which has been suspended by a STOP charac- 
ter. While output is not suspended, START char- 
acters are ignored and not read. The start/stop 
characters cannot be changed or escaped. 

The character values for INTR, QUIT, SWITCH, ERASE, 
KILL, EOF, and EOL may be changed to suit individual 
tastes. The ERASE, KILL, and EOF characters may be 
escaped by a preceding \ character, in which case no 
special function is done. 

When the carrier signal from the data-set drops, a hang-up 
signal is sent to all processes that have this terminal as 
the control terminal. Unless other arrangements have been 
made, this signal causes the processes to terminate. If 
the hang-up signal is ignored, any subsequent read returns 
with an end-of-file indication. Thus, programs that read 
a terminal and test for end-of-file can terminate appro- 
priately when hung up on. 

When one or more characters are written, they are trans- 
mitted to the terminal as soon as previously-written char- 
acters have finished tj^ing. Input characters are echoed 
by putting them in the output queue as they arrive. If a 
process produces characters more rapidly than they can be 
typed, it will be suspended when its output queue exceeds 
some limit. When the queue has drained down to some 
threshold, the program is resumed. 
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Several ioctl(S) system calls apply to terminal files. 
The primary calls use the following structure, defined in 
<termio.h>: 



NCC 


8 








termio { 










unsigned 


short 


c 


if lag; 


/*input modes*/ 


unsigned 


short 


c 


of lag; 


/♦output modes*/ 


unsigned 


short 


c_ 


cf lag; 


/♦control modes*/ 


unsigned 


short 


c 


_lflag; 


/*local modes*/ 


char 




c_ 


line; 


/*line discipline*/ 


unsigned 


char 


c 


_cc[NCC] ; 


/♦control chars*/ 



}; 

The special control characters are defined by the array 
c_cc. The relative positions and initial values for each 
function are as follows: 



0 


VINTR 


DEL 


1 


VQUIT 


FS 


2 


VERASE 


# 


3 


VKILL 


@ 


4 


VEOF 


EOT 


5 


VEOL 


NUL 


6 


reserved 




7 


SWTCH 





The c_iflag field describes the basic terminal input con- 
trol: 



IGNBRK 


0000001 


Ignore break condition 


BRKINT 


0000002 


Signal interrupt on break 


IGNPAR 


0000004 


Ignore characters with parity 






errors 


PARMRK 


0000010 


Mark parity errors 


INPCK 


0000020 


Enable input parity check 


ISTRIP 


0000040 


Strip character 


INLCR 


0000100 


Map NL to CR on input 


IGNCR 


0000200 


Ignore CR 


ICRNL 


0000400 


Map CR to NL on input 


lUCLC 


0001000 


Map uppercase to lowercase 






on input 


IXON 


0002000 


Enable start/stop output 






control 


IXANY 


0004000 


Enable any character to 






restart output 


IXOFF 


0010000 


Enable start/stop input 






control 
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If IGNBRK is set, the break condition (a character framing 
error with data all zeros) is ignored, that is, not put on 
the input queue and therefore not read by any process. 
Otherwise, if BRKINT is set, the break condition will gen- 
erate an interrupt signal and flush both the input and 
output queues. If IGNPAR is set, characters with other 
framing and parity errors are ignored. 

If PARMRK is set, a character with a framing or parity 
error which is not ignored is read as the three-character 
sequence: 0377, 0, X, where X is the data of the charac- 
ter received in error. To avoid ambiguity in this case, 
if ISTRIP is not set, a valid character of 0377 is read as 
0377,0377. If PARMRK is not set, a framing or parity 
error which is not ignored is read as the character 
NUL(O). 

If INPCK is set, input parity checking is enabled. If 
INPCK is not set, input parity checking is disable. This 
allows output parity generation without input parity 
errors. 

IF ISTRIP is set, valid input characters are first 
stripped to 7-bits, otherwise all 8-bits are processed. 

If INLCR is set, a received NL character is translated 
into a CR character. If IGNCR is set, a received CR char- 
acter is ignored (not read). Otherwise, if ICRNL is set, 
a received CR character is translated into a NL character. 

If lUCLC is set, a received uppercase alphabetic character 
is translated into the corresponding lowercase character. 

If IXON is set, start/stop output control is enabled. A 
received STOP character will suspend output and a receive* 
START character will restart output. All start/stop char- 
acters are ignored and not read. If IXANY is set, any 
input character will restart output which has been sus- 
pended. 

If IXOFF is set, the system will transmit START/STOP cha 
acters when the input queue is nearly empty /full. 

The initial input control value is all-bits-clear. 
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The c oflag field specifies the system treatment of out- 
put: 









r\T r*! Tr" 


uuuuuuz 


Map lowercase to upper on 






output 


/^TVTT CXf 


UUUUUU4 


iviap i\L to uK-i\L on output 


*J<^K1\ L 


UUUUUiU 


Map CR to NL on output 




nnnnnon 


No CR output at column 0 


OMT PPT 


UUUUU^iU 


iMjj perroriiis k^k lunction 


/^T7TT T 

OrlLL 


0000100 


Use fill characters for 






delay 


OFDEL 


0000200 


T?in i« T*\T7T A.TTTT 

rlli is UEL, else NUL 


TVTT TNT \7 

NLDLY 


0000400 


Select new-line delays: 


NLU 


0 




IVTT 1 


UUUu4UU 




CRDLY 


0003000 


Selector carriage-return 






delays: 


CRO 


0 






AAA 1 AAA 

0001000 






AAAOAA A 

0002000 




CR3 


0003000 




TABDLY 


0014000 


Select horizontal-tab 






delays: 


lAJoU 


A 
0 




T'ATJI 


AAA/1 AAA 

UUu4UUU 




T" A UO 

1 HrJ^ 


UUiUUUU 






A A 1 /I AAA 
UU14UU0 


Expand tabs to spaces 


BbDLY 


AAOAAAA 

OOzOOOO 


Select backspace delays: 


BSO 


0 




BSl 


0020000 




VTDLY 


0040000 


Select verical-tab delays: 


VTO 


0 




VTl 


0040000 




FFDLY 


0100000 


Select form-feed delays: 


FFO 


0 




FFl 


0100000 





If OPOST is set, output characters are post-processed as 
indicated by the remaining flags, otherwise characters are 
transmitted without change. 

If OLCUC is set, a lowercase alphabetic character is 
transmitted as the corresponding uppercase character. 
This function is often used in conjunction with lUCLC. 
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IF ONLCR is set, the NL character is transmitted as the 
CR-NL character pair. If OCRNL is set, the CR character 
is transmitted as the NL character. If ONOCR is set, no 
CR character is transmitted when at column 0 (first 
position). If ONLRET is set, the NL character is assumed 
to do the carriage-return function; the column pointer 
will be set to 0 and the delays specified for CR will be 
used. Otherwise the NL character is assumed to do just 
the line-feed function; the column pointer will remain 
unchanged. The column pointer is also set to 0 if the CR 
character is actually transmitted. 

The delay bits specify how long transmission stops to al- 
low for mechanical or other movement when certain charac- 
ters are sent to the terminal. In all cases a value of 0 
indicates no delay. If OFILL is set, fill characters will 
be transmitted for delay instead of a timed delay. This 
is useful for high baud rate terminals which need only a 
minimal dealy. If OFDEL is set, the fill character is 
DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it 
lasts for about two seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is 
set, the carriage-return delays are used instead of the 
new-line delays. If OFILL is set, two fill characters 
will be transmitted. 

Carriage-return delay type 1 is dependent on the current 
column position, type 2 is about 0.10 seconds, and type 3 
is about 0.15 seconds. If OFILL is set, delay type 1 
transmits two fill characters, and type 2, four fill char- 
acters. 

Horizontal-tab delay type 1 is dependent on the current 
column position. Type 2 is about 0.10 seconds. Type 3 
specifies that tabs are to be expanded into spaces. If 
OFILL is set, two fill characters will be transmitted for 
any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is 
set, one fill character will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 
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The c cflag field describes the hardware control of the 
terminal: 



CBAUD 


0000017 


Baud rate: 


BO 


0 


Hang up 


B50 


0000001 


50 baud 


B75 


0000002 


75 baud 


BllO 


0000003 


110 baud 


B134 


0000004 


134.5 baud 


B150 


0000005 


150 baud 


B200 


0000006 


200 baud 


B300 


0000007 


300 baud 


B600 


0000010 


600 baud 


B1200 


0000011 


1200 baud 


B1800 


0000012 


1800 baud 


B2400 


0000013 


2400 baud 


B4800 


0000014 


4800 baud 


B9600 


0000015 


9600 baud 


B19200 


0000016 


19200 baud 


B38400 


0000017 


38400 baud (not supported) 


CSIZE 


0000060 


Character size: 


CSS 


0 


5 bits 


CS6 


0000020 


6 bits 


CS7 


0000040 


7 bits 


CSS 


0000060 


8 bits 


CSTOPB 


0000100 


Send two stop bits, else one 


CREAD 


0000200 


Enable receiver 


PARENS 


0000400 


Parity enable 


PARODD 


0001000 


Odd parity, else even 


HUPCL 


0002000 


Hang up on last close 


CLOCAL 


0004000 


Local line, else dial-up 


RCVIEN 


0010000 




XMTIEN 


0020000 




LOBLK 




Block layer output 0040000 



The CBAUD bits specify the baud rate. The zero baud rate, 
BO, is used to hang up the connection. If BO is speci- 
fied, the dataterminal-ready signal will not be asserted. 
Normally, this will disconnect the line. For any particu- 
lar hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both 
transmission and reception. This size does not include 
the parity bit, if any. If CSTOPB is set, two stop bits 
are used, otherwise one stop bit. For example, at 110 
baud, two stop bits are required. 
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If PARENS is set, parity generation and detection is en- 
abled and a parity bit is added to each character. If 
parity is enabled, the PARODD flag specifies odd parity if 
set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no 
characters will be received. 

If HUPCL is set, the operating system disconnects ("hangs 
up") the line when the last process (or file) for that 
port closes. That is, the dataterminal-ready signal be- 
comes false (is not asserted). If HUPCL is false, the 
data-terminal-ready signal remains true even after the 
last close on the port. 

If CLOCAL is set when a port is opened, the operating sys- 
tem assumes the line is a local, directly connected port 
(i.e., there is no modem control) and the open completes 
without waiting for carrier. The dataterminal-ready and 
request-to-send signals are asserted, and incoming modem 
signals are ignored. If CLOCAL is false for a port when 
opening it, the operating system assumes there is modem 
control, and the open waits for the carrier-detect to be 
true (if the O NDELAY flag is not set on the file (see 
fcntl.h)). The data- terminal-ready and request-to-send 
signals are asserted. 

The operating system also checks CLOCAL when a modem in 
terrupt occurs, usually when the data-terminal-ready sig- 
nal changes. The operating system assumes that the data- 
terminal-ready signal reflects the carrier sense of the 
modem and will kill the process group for the port if 
data-terminal-ready goes from true to false. If data- 
terminal-ready goes from false to true, the operating sys- 
tem wakes up any open requests waiting for carrier-detect 
to go true. If CLOCAL is true, the operating system dis- 
ables modem interrupts. 

Finally, CLOCAL also affects hardware flow control. If 
CLOCAL is false, the operating system does not enable any 
hardware flow control, regardless of the setting of hard- 
ware flow control (see SETFLOW below) flags. 

The initial hardware control value after open is B9600, 
CSS, CREAD, HUPCL for modem ports, and B9600, CSS, 
CREAD, CLOCAL for local ports. 
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If LOBLK is set, the output of a job control layer will be 
blocked when it is not the current layer. Otherwise the 
output generated by that layer will be multiplexed onto 
the current layer. 

The initial hardware control value after open is B300, 
CSS, CREAD, HUPCL. 

The c_lflag field of the argument structure is used by the 
line discipline to control terminal functions. The basic 
line discipline (0) provides the following: 



ISIG 


0000001 


Enable signals 


ICANON 


0000002 


Canonical input (erase and 






kill processing 


XCASE 


0000004 


Canonical upper/ower 






presentation 


ECHO 


0000010 


Enable echo 


ECHOE 


0000020 


Echo erase character as 






BS-SP-BS 


ECHOK 


0000040 


Echo NL after kill character 


ECHONL 


0000100 


Echo NL 


NOFLSH 


0000200 


Disable flush after interrupt 



or quit 

If ISIG is set, each input character is checked against 
the special control characters INTR, SWTCH, and QUIT. If 
an input character matches one of these control charac- 
ters, the function associated with that character is per- 
formed. If ISIG is not set, no checking is done. Thus 
these special input functions are possible only if ISIG is 
set. These functions may be disabled individually by 
changing the value of the control character to an unlikely 
or impossible value (e.g., 0377). 

If ICANON is set, canonical processing is enabled. This 
enables the erase and kill edit functions, and the as- 
sembly of input characters into lines delimited by NL, 
EOF, and EOL. If ICANON is not set, read requests are 
satisfied directly from the input queue. A read will not 
be satisfied until at least MIN characters have been re- 
ceived or the timeout value TIME has expired between char- 
acters. This allows fast bursts of input to be read effi- 
ciently while still allowing single character input. The 
MIN and TIME values are stored in the position for the 
EOF and EOL characters, respectively. The time value 
represents tenths of seconds. 
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If XCASE is set, and if ICANON is set, an uppercase letter 
is accepted on input by preceding it with a \ character, 
and is output preceded by a \ character. In this mode, 
the following escape sequences are generated on output and 
accepted on input: 

for: use: 



For example, A is input as \a, \n as \\n, and \N as \\\n. 

If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are pos- 
sible. If ECHO and ECHOE are set, the erase character is 
echoed as ASCII BS SP BS, which will clear the last char- 
acter from a CRT screen. If ECHOE is set, the NL char- 
acter will be echoed after the kill character to emphasize 
that the line will be deleted. 

Note that an escape character preceding the erase or kill 
character removes any special function. If ECHONL is set, 
the NL character will be echoed even if ECHO is not set. 
This is useful for terminals set to local echo (so-called 
half duplex). Unless escaped, the EOF character is not 
echoed. Because EOT is the default EOF character, this 
prevents terminals that respond to EOT from from hanging 
up. 

If NOFLSH is set, the normal flush of the input and output 
queues associated with the quit, switch, and interrupt 
characters will not be done. 

The initial line-discipline control value is all bits 
clear. 

The primary ioctl(S) system calls have the form: 

ioctl {filedeSf command, arg) 
struct termio *arg; 



{ 
} 

\ 



\' 
\! 
\^ 
\( 
\) 
W 
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The commands using this form are: 
TCGETA 

Get the parameters associated with the terminal and 
store in the termio structure referenced by arg. 

TCSETA 

Set the parameters associated with the terminal from 
the structure referenced by arg. The change is im- 
mediate. 

TCSETAW 

Wait for the output to drain before setting the new 
parameters. This form should be used when changing 
parameters that will affect output. 

TCSETAF 

Wait for the output to drain, then flush the input 
queue and set the new parameters. 

Another group of ioctl system calls have the form: 

ioctl ifiledeSf command, arg) 
char *arg; 

The commands using this form are: 

SETFLOW 

Sets the hardware flow control bits, defined as 
TXHARD and RXHARD for the terminal. If the 
TXHARD bit is set, hardware output flow control 
is enabled. If the RXHARD bit is set, hardware input 
flow control is enabled. The argument is a pointer 
to a byte with these bits set (or not). The software 
flow control bits (TXSOFT and RXSOFT) are ignored. 

GETFLOW 

Returns the hardware flow control bits. The argument 
is a pointer to a byte with these bits set (or not). 

Additional ioct calls have the form: 

ioctl {filedeSf command, arg) 
int arg; 
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The commands using this form are: 
TCSBRK 

Wait for the output to drain. If arg is 0, then send 
a break (zero bits for 0.25 seconds). 

TCXONC 

Start/stop control. If arg is 0, suspend output; if 
1, restart suspended output. 

TCFLSH 

If arg is 0, flush the input queue; if 1, flush the 
output queue; if 2, flush both the input and output 
queues. 

SETMODEM 

Sets the modem mode to USER, ON, or OFF for the 
terminal. Arg should be either MDM_ON, MDM OFF, 
or MDM_USER. 

GETMODEM 

Returns the current modem setting, either MDM ON, 
MDM_OFF, MDM_USER. Arg is ignored. 

See ioctl(S) for details on how to use this system call. 



Files 

/dev/tty 

/dev/tty* 

/dev/console 



See Also 

ioctl(S), stty(C), xtty(C) 



13 



TIMEZONE(M) 



TIMEZONE(M) 



Name 

timezone - Sets default system time zone. 

Syntax 

/etc/TIMEZONE 

Description 

This file sets and exports the time zone environmental 
variable TZ. This file is included into other files that 
must know the time zone. 

Examples 

/etc/TIMEZONE for the East coast: 

# Time Zone 
TZ=EST5EDT 
export TZ 



See Also 

rc2(M), profile(M), and ctime(S) in the Reference (CP, 
S, F) 
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Name 

ttys - Login terminals file. 



Syntax 

/etc/ttys 



Description 

The /etc/ttys file contains a list of the device special 
files associated with possible login terminals. 

The file contains one or more entries of the form: 

state mode name 

The name must be the filename of a device special file. 
Only the filename may be supplied, the path is assumed to 
be /dev. If state is "1", the device is enabled for 
logins; if "0", the device is disabled. The mode is used 
as an argument to the getty program. It defines the line 
speed and type of device associated with the terminal. A 
list of arguments is provided in getty. 

For example, the entry "16tty02" means the serial line 
tty02 is to be enabled for logging in at 9600 baud. 



Files 

/etc/ttys 



See Also 

getty(M), pconfig(C) 



Notes 

Edit the /etc/ttys file only when in system maintenance 
mode. This file is obsolete, and is maintained only for 
the convenience of old programs. Init(M) no longer ex- 
amines this file. 
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Name 

utmp, wtmp - Utmp and wtmp entry formats. 



Syntax 



^include <sys/types.h> 
^include <utmp.h> 



Description 

These files, which hold user and accounting information 
for such commands as who(C), write(C), and logln(M), have 
the following structure as defined by <utmp.h>: 



#define UTMP_FILE "/etc/utmp" 

#define WTMP_FILE "/etc/wtmp" 

fdefine ut name ut user 



struct utmp 


{ 






char 


ut_user [8] ; 


/* 


User login name */ 


char 


ut_id[4] ; 


/* 


/etc/inittab id (usually line #) 


char 


ut_line[12] ; 


/* 


device name (console, Inxx) */ 


short 


ut_pid; 


/* 


process id */ 


short 


ut_tYpe; 


/* 


type of entry */ 


struct 


exit_status { 






short 


e termination; 


/* 


Process termination status */ 


short 


e exit ; 


/* 


Process exit status */ 


} ut_exit 




/* 


The exit status of a process 






* 


marked as DEAD_PROCESS . */ 


time_t 


ut_time; 


/* 


time entry was made */ 



}; 



/* Definitioins for ut_ 


type 


*/ 




#def ine 


EMPTY 


0 






#def ine 


RUN/LVL 


1 






#def ine 


BOOT_TIME 


2 






#define 


OLD_TIME 


3 






#def ine 


NEW_TIME 


4 






#def ine 


1NIT_PR0CESS 


5 


/* 


Process spawned by "init" */ 


#def ine 


LOGIN_PROCESS 


6 


/* 


A "getty" process waiting for login 


#def ine 


USER_PROCESS 


7 


/* 


A user process */ 


#def ine 


DEAD_PROCESS 


8 






#def ine 


ACCOUNTING 


9 






#def ine 


UTMAXTYPE 


ACCOUNTING /* Largest legal value of */ 



/* ut_type */ 
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/* Special strings or formats used in the "ut_line" field accounting */ 

/* accounting for something other than a process */ 

/* No string for the ut_line field can be more than 11 chars + */ 

/* a NULL in length */ 

#define RUNLVL_MSG "run-level %c" 

#define BOOT_MSG "system boot" 

#define OTIMEMSG "old time" 

#define NTIME_MSG "new time" 

Files 

/etc/utmp 
/etc/wtmp 



See Also 

getut(S), login(C), who(C), write(C) 
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Name 

uucheck - Checks the uucp directories and permissions 
file. 



Syntax 

/usr/llb/uucp/uucheck [ -v ] [ -x debug level ] 



Description 

Uucheck checks for the presence of the uucp system re- 
quired files and directories. Within the uucp makefile, 
it is executed before the installation takes place. It 
also checks for some obvious errors in the permissions 
file (/usr/iib/uucp/Permissions). When executed with the 
-V option, it gives a detailed explanation of how the uucp 
programs will interpret the permissions file. The -x op- 
tion is used for debugging. Debug level is a single digit 
in the range 1-9; the higher the value, the greater the 
detail. Note that uucheck can only be used by the 
super-user or uucp. 



Files 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 



See Also 

uucico(M), uusched(M), uucp(C), uustat(C), uux(C) 



Notes 

The program does not check file /directory modes or some 
errors in the permissions file such as duplicate login or 
machine names. 
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Name 

uucico - File transport program for the uucp system. 



Syntax 

/usr/lib/uucp/uucico [ -r role number ] [ -x debug level ] 
[ -i interface ] [ -d spool directory ] -s system name 



Description 

Uucico is the file transport program for uucp work file 
transfers. Role numbers for the -r option are the digit 1 
for master mode or 0 for slave mode (default). The -r 
option should be specified as the digit 1 for master mode 
when uucico is started by a program or cron(C). Uux and 
uucp both queue jobs that will be transferred by uucico. 
It is normally started by the scheduler, uusched, but can 
be started manually for debugging. For example, the 
script uutry starts uucico with debugging turned on. A 
single digit must be used for the -x option with higher 
numbers for more debugging. The -i option defines the 
interface used with uucico. This interface only affects 
slave mode. Known interfaces are UNIX (default), TLI 
(basic Transport Layer Interface), and TLIS (Transport 
Layer Interface with Streams modules, read/write). 



Files 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Devconfig 

/usr/lib/uucp/Sysfiles 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 



See Also 

cron(C), uusched(M), uutry(M), uucp(C), uustat(C), uux(C) 
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Name 

uucleanup - Uucp spool directory cleanup. 



Syntax 

/usr/iib/uucp/uucieanup [ -Ctime ] [ -Wtime ] [ -Dtime ] 
[ -Xtime ] [ -mstring ] [ -otime ] [ -ssystem ] 
[ -xdebug level ] 



Description 

Uucleanup will scan the spool directories for old files 
and take appropriate action to remove them in a useful 
way: 

• Inform the requestor of send/receive requests for 
systems that cannot be reached. 

• Return mail, which cannot be delivered, to the 
sender. 

• Delete or execute mews for rnews type files 
(depending on where the news originated—locally or 
remotely). 

• Remove all other files. 

In addition, there is provision to warn users of requests 
that have been waiting for a given number of days (default 
1). Note that uucleanup will process as if all option 
times were specified to the default values, unless time is 
specifically set. 

The following options are available. 

-Ctime Any C. files greater or equal to time days 

old will be removed with appropriate infor- 
mation to the requestor (default 7 days). 

-Dtime Any D. files greater or equal to time days 

old will be removed. An attempt will be 
made to deliver mail messages and execute 
mews when appropriate (default 7 days). 



1 



UUCLEANUP(M) 



UUCLEANUP(M) 



-VJtime 



-Xtime 



-mstring 



-otime 



-ssystem 
-xdebug level 



Any C. files equal to time days old will 
cause a mail message to be sent to the re- 
questor warning about the delay in contact- 
ing the remote (default 1 day). The mes- 
sage includes the JOBID^ and in the case of 
mail, telling whom to call to check the 
problem (-m option). 

Any X. files greater or equal to time days 
old will be removed (default 2 days). The 
D. files are probably not present (if they 
were, the X. could get executed). But if 
there are D. files, they will be taken 
care of by D. processing. 

This line will be included in the warning 
message generated by the -W option. 

Other files whose age is more than time 
days will be deleted (default 2 days). The 
default line is "See your local administra- 
tor to locate the problem." 

Execute for system spool directory only. 

The -X debug Jevel is a single digit be- 
tween 0 and 9; higher numbers give more 
detailed debugging information. (If 
uucleanup was compiled with -DSMALL, no 
debugging output will be available.) 

This program is typically started by the 
shell uudemon. cleanup, which should be 
started by cron(C). 



Files 



/usr/lib/uucp 
/usr/spool/uucp 



Directory with commands used by 
uucleanup internally 
Spool directory 



See Also 

cron(C), uucp(C), uux(C) 
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Name 

uugetty - Sets terminal tjTpe, modes, speed, and line dis- 
cipline. 



Syntax 

/usr/lib/uucp/uugetty [-h] [-t timeout] [-r] line [speed 

[type [linedisc]]] 
/usr/lib/uucp/uugetty -c file 



Description 

Uugetty is identical to getty(M) but changes have been 
made to support using the line for uucico, cu, and ct; 
that is, the line can be used in both directions. Uugetty 
will allow users to log in, but if the line is free, 
uucico, cu, or ct can use it for dialing out. The imple- 
mentation depends on the fact that uucico, cu, and ct 
create lock files when devices are used. When the open(S) 
returns (or the first character is read when -r option is 
used), the status of the lock file indicates whether the 
line is being used by uucico, cu, ct, or someone trying to 
log in. Note that in the -r case, several carriage-return 
characters may be required before the login message is 
output. The users will be able to handle this slight in- 
convenience. Uucico trying to log in will have to be told 
by using the following login script: 

\r\d\r\d\r\d\r in:~in:... 

where the ... is whatever would normally be used for the 
login sequence. 

An entry for an intelligent modem or direct line that has 
a uugetty on each end must use the -r option. (This 
causes uugetty to wait to read a character before it puts 
out the login message, thus preventing two uugettys from 
looping.) If there is a uugetty on one end of a direct 
line, there must be a uugetty on the other end as well. 
Here is an /etc/inittab entry using uugetty on an intelli- 
gent modem or direct line: 
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ttl2:2:respawn:env - TERM=altos5 
/usr/lib/uucp/uugetty -r -t 60 ttyl2 1200 

For an explanation of uugetty options, see getty(M). 

Files 

/etc/gettydefs 
/etc/issue 

See Also 

uucico(M), getty(M), init(M), tty{M), cu(C), login(M) 
gettydefs(M), inittab(M), and ioctl(S) in the Reference 
(CP, S, F) 

Notes 

Uugetty does not support linking of device files. 
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Name 

uusched - Scheduler for the uucp file transport program. 



Syntax 

/usr/lib/uucp/uusched [ -x debug level ] [ -u debug level ] 



Description 

Uusched is the uucp file transport scheduler. It is 
usually started by the daemon uudemon.hour that is started 
by cron(C) from an entry in /usr/spool/cron/crontab: 

39 « * * */bin/su uucp -c "/usr/lib/uucp/uudemon.hour > /dev/null" 

The two options are for debugging purposes only; -x 
debug level will output debugging messages from uusched 
and -u debug level will be passed as -x debug level to 
uucico. The debug level is a number between 0 and 9; 
higher numbers give more detailed information. 



FUes 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 



See Also 

cron(C), uucico(M), uucp(C), uustat(C), uux(C) 
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Name 

Uutry - Tries to contact remote system with debugging on. 



Syntax 

/usr/lib/uucp/Uutry [ -x debug Jevel ] [ -r ] system_name 



Description 

Uutry is a shell that is used to invoke uucico to call a 
remote site. Debugging is turned on (default is level 5); 
-X will override that value. The -r overrides the retry 
time in /usr/spool/uucp/. status. The debugging output is 
put in file /imp/ system jiame. A tail -f of the output is 
executed. A <DELETE> or <BREAK> will give control back 
to the terminal while the uucico continues to run, putting 
its output in / tmp/sy stem_name. 



Files 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

/tmp/system_name 



See Also 

uucico(M), uucp(C), uux(C) 
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Name 

uuxqt - Executes remote command requests. 



Syntax 

/usr/lib/uucp/uuxqt [ -s system ] [ -x debug level ] 



Description 

Uuxqt is the program that executes remote job requests 
from remote systems generated by the use of the uux com- 
mand. (Mail uses uux for remote mail requests.) Uuxqt 
searches the spool directories looking for X. files. For 
each X. file, uuxqt checks to see if all the required 
data files are available and accessible, and file commands 
are permitted for the requesting system. The Permissions 
file is used to validate file accessibility and command 
execution permission. 

There are two environment variables that are set before 
the uuxqt command is executed: 

UU_MACHINE is the machine that sent the job (the 
previous one). 

UU_USER is the user that sent the job. 

These can be used in writing commands that remote systems 
can execute to provide information, auditing, or restric- 
tions. The -X debug level is a single digit between 0 and 
9. Higher numbers give more detailed debugging informa- 
tion. 



Files 

/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 



See Also 

uucico(M), uucp(C), uustat(C), uux(C), mail(C) 
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Name 

volcopy, labelit - Copies file systems with label check- 
ing. 



Syntax 

/etc/volcopy [options] fsname speciall volnamel special2 
volname2 

/etc/labelit special [fsname volume [-n]] 



Description 

The volcopy command makes a literal copy of the file sys- 
tem using a blocksize matched to the device. 

The labelit command creates a label for an unmounted disk 
file system or a volcopy archive device. The -n option 
provides for initial labeling on tapes only (this destroys 
previous contents). Otherwise, a label must already exist 
and only the fsname and volume arguments are modified. II 
all optional arguments are omitted, labelit prints the 
current label values of the special device. 



Options 



Invokes a verification sequence requiring a pos- 
itive operator response instead of the standard 
10-second delay before the copy is made. 



Prompts the user before the copy is made. The 
copy is aborted if the user presses 
within 10 seconds (default). 



Break/Del 



-y Assumes a "yes" response to all questions. 

The following additional options are used only with tapes: 

-reelnum Specifies the beginning reel number for a 

restarted copy. 

-buf Uses double-buffered I/O. 
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-teetnum 



Specifies the tape length, only valid when 
using reel tape. 



-bpinum 



Specifies the tape density (bits/inch), 
only valid when using reel tape. 



-tr 



Specifies reel tape. 



-tc 



Specifies cartridge tape. 



-scsi 



Assumes tape drive is of scsi type, only 
valid when using cartridge tape. 



-nonscsi 



Assumes tape drive is not scsi type, only 
valid when using cartridge tape. 



-typeLABEL 



Specifies the type of cartridge tape being 
used, only valid when using cartridge tape. 



The program requests length and density information if it 
is not given on the command line or is not recorded on an 
input tape label. Reel or cartridge tapes may be used. 
If the file system is too large to fit on one reel, 
volcopy will prompt for additional reels. Labels of all 
reels are checked. 

If volcopy is interrupted, it will ask if the user wants 
to quit or wants a shell. In the latter case, the user 
can perform other operations, such as labelit, and return 
to volcopy by exiting the new shell. 

The fsname argument represents the mounted name (for ex- 
ample, root or usr) of the file system being copied. The 
special argument should be the physical disk section or 
tape, for example, /dev/rhdOb or /dev/rct. 

The volname argument is the physical volume name (for ex- 
ample, rhdOb), and should match the external label stick- 
er. Such label names are limited to six or fewer charac- 
ters. To use the existing volume name, specify ~ for the 
volname argument. 

The arguments speciall and volnamel are the device and 
volume from which the copy of the file system is being 
extracted. The arguments special2 and volname2 are the 
target device and volume. 
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Neither the source or target device should have a file 
system mounted while running volcopy, or while creating a 
label with labelit. The exception is for the / file sys- 
tem, where you should be in single-user mode. (You can 
read the label of a mounted file system with labelit.) 

The values for fsname and volname are recorded in the last 
12 characters of the superblock (char fsname[6], 
volname[6];). 



Examples 

To label a tape for the / file system, with volume label 
vOOl, go to single-user mode and enter: 

/etc/labeUt /dev/rct / vOOl 

To archive the / file system on a tape, labeled as in the 
above example, enter: 

/etc/volcopy / /dev/rhdOb hdOb /dev/rct vOOl 

To restore a tape (archived as above) of the / file system 
to disk, enter: 

/etc/volcopy / /dev/rct vOOl /dev/rhdOb hdOb 

Note that when using volcopy for the / file system, go to 
single-user mode. 



Files 

/etc/log/f ilesave.log Record of file systems/volume 

copied 



See Also 

sh(C) 



Notes 

Only device names beginning with /dev/rct are treated as 
tapes. 
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Name 

vt - Virtual terminal management (Series 500 only). 



The virtual terminal (VT) device driver is a layer of man- 
agement functions that provides the facilities to support 
and switch between up to eight screen faces on each phys- 
ical device. Terminal or display device drivers that have 
been written to take advantage of this facility can there- 
fore present multiple VTs on a single physical device. 
The correspondence between physical and virtual terminals 
is determined using the minor device number of the phys- 
ical device, with the bottom five bits selecting the phys- 
ical device and the top three bits selecting the virtual 
terminal. 

Virtual terminals are accessed in exactly the same way as 
any other device. The open(S) system call is used to open 
the virtual terminal, and read(S), write(S), and ioctl(S) 
are used in the normal way and support all the functional- 
ity of the underlying device. In addition, some 
VT-specific loctl calls are provided as described below. 

Virtual terminals provide the link between different 
screen faces and the device. The virtual terminal that 
corresponds to the currently visible screen face is called 
the active virtual terminal. The active VT is the one 
that input from the device will be directed to, and any 
device-specific modes that can change on a per-VT basis 
will be set to the characteristics associated with the 
active VT. 

Open virtual terminals on a device are placed on a "ring," 
with the active VT always being the VT on the top of the 
ring. The ring can be cycled through via a "hot key" that 
is specific to the underlying device driver. The first 
open of a VT causes it to be placed at the top of the ring 
and become the active VT. The last close on a VT causes 
it to be removed from the ring, and if this was the active 
VT, the previous VT on the ring becomes the active one. 

Virtual terminal switching can be done in two different 
modes: automatically on receipt of a hot key, or under 
control of the process owning the VT. In the first case. 
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the process associated with the VT knows nothing about the 
switch and it is handled entirely by the underlying device 
driver and the virtual terminal manager. In 
process-controlled switch mode, when a switch hot key is 
sent, the process owning the VT is sent a signal (see 
sigset(S)) that it has specified to the VT manager. This 
signal requests the process to release the physical de- 
vice. The VT manager then awaits an ioctl from the pro- 
cess indicating that the VT either has released the phys- 
ical device (in which case a switch occurs), or refuses to 
release the device (in which case the switch does not 
occur). If a predefined time limit expires before the 
ioctl is received from the process owning the VT, the VT 
manager behaves as if an ioctl indicating refusal was re- 
ceived. The ring of active VTs can contain intermixed 
auto mode and process control mode VTs. Process control 
mode VTs will be sent a signal that they have specified 
when they become the active VT. Some device drivers may 
support a forced switch mode, in which case an alternate 
hotkey sequence will cause the driver to force a switch to 
the next VT even if a normal switch is refused. The driv- 
er does the forced switch and the VT manager signals the 
VT that it has been forced out. 



Ioctl Calls 

The following ioctl calls apply to any device that sup- 
ports VTs. 

VTOPENQRY 

This call is used to find an available VT. The argu- 
ment to the ioctl is a pointer to a long. The long 
will be filled in with the number of the first avail- 
able VT that no other process has open (this may be 
the one currently opened). If there are no available 
VTs then -1 will be filled in. 

VTGETMODE 

This call is used to determine what mode the VT is 
currently in, either VT AUTO or VT PROCESS. The 
argument to the ioctl is the address of the following 
structure, as defined in <sys/vt.h>. 
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struct vt_mode { 

char mode; /* VT mode */ 

char waitv; /* if non-zero, hang on writes when 
not active */ 

short relsig; /* signal to use for release request */ 
short acqsig; /* signal to use for display acquired */ 
short frsig; /* signal to use for forced release */ 

} 

/* Virtual Terminal Modes */ 

#define VT_AUTO 0/* automatic VT switching */ 

#define VT_PROCESS 1/* process controls switching */ 

The structure will be filled in with the current 
value for each field. 

VTSETMODE 

This call is used to set the VT mode. The argument 
to the ioctl is a pointer to a vt mode structure, as 
defined above. The structure should be filled in 
with the desired VT mode and whether or not to block 
on writes when not active. If process-control mode 
is specified then the signals that should be used to 
communicate with the process should be specified. If 
any of the signals are not specified (value is zero), 
then the default for that signal will be used 
(SIGUSRl for relsig and acqsig and SIGUSR2 for 
frsig). 

VTRELDISP 

This call is used to tell the VT manager if the dis- 
play has been released or if the process has refused 
to release the display. A non-zero argument signals 
release and zero indicates refusal to release. 



VTACTIVATE 

This call has the effect of making the VT specified 
in the argument the active VT. The VT manager will 
cause a switch to occur in the same manner as if a 
hotkey had initiated the switch. If the specified VT 
is not open or does not exist, the call will fail and 
errno will be set to ENXIO. 



Files 

/dev/vtxxn 
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See Also 

ioctl(S), sighold(S), signal(S), sigrelse(S), sigset(S) 



Warnings 

There is a potential for a race condition on a heavily 
loaded system. When a process-control mode VT is sent the 
release requested signal, it is possible that it may not 
reply with a release ioctl before the internal timer ex- 
pires and refusal to switch is assumed. The switch re- 
quest will then be canceled and the VT will not switch 
screen faces. This can be detected by the process at- 
tempting to release the display. If the release ioctl 
fails and enno is EINVAL, then the releasing process can 
assume that the switch request was canceled. 
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Name 

whodo - Shows who is doing what. 

Syntax 

/etc/whodo 



Description 

Whodo produces formatted and dated output from information 
in the /etc/utmp and /etc/ps data files. 

The display is headed by the date, time, and machine name. 
For each user logged in, device name, user-id and login 
time is shown, followed by a list of active processes as- 
sociated with the user-id. The list includes the device 
name, process-id, cpu minutes and seconds used, and pro- 
cess name. 



Example 

The command: 
whodo 

produces a display like this: 

Tue Mar 12 15:48:03 1985 
bailey 

ttyOg men 8:51 

tty09 28158 0:29 sh 

tty52 bdr 15:23 

tty52 21688 0:05 sh 
tty52 22788 0:01 whodo 
tty52 22017 0:03 vi 
tty52 22549 0:01 sh 

xtl62 lee 10:20 



tty08 


6748 


0; 


;01 


layers 


xtl62 


6751 


0: 


;01 


sh 


xtl63 


6761 


0: 


;05 


sh 


tty08 


6536 


0: 


:05 


sh 
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Files 

/etc/passwd 
/etc/psdata 
/etc/utmp 

See Also 

ps{C), who(C) 
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Name 

xpd - Transparent printer daemon. 

Syntax 

xpd tty Ip type 

Description 

The xpd daemon directs any output sent to the Ip device to 
the printer attached to the tty device printer port. 

tty is the name of the terminal device to which the 

printer is attached. It must be invoked as 
/dev/tty, 

Ip is the name of a FIFO special device to be used 

by the printer. It must be invoked as /dev/lp. 

type is the name of the terminal type. The altos2, 

altos3, altos4, altosS, and Wyse 30 terminals 
are supported. 

Files 

/dev/tty?? 
/dev/lp? 

Also See 

mknod(C) 



hange Information 



This is a summary of the changes that have been made to 
the previous version of this manual. The chapters, page 
numbers, and/or paragraphs mentioned in this sunmiary ref- 
I erence the previous manual. 

tie: Altos System V Series 386 Reference (M) 

ivised Part Number: 690-22870-002 

evious Part Number: 690-22870-001 

ite: June 1989 

anges: 

Updated the Permuted Index and Table of Contents. 
Added allases(M) and aliashash(M). 
Changed rc5(M) to rcO(M). 
Changed the following pages: 

Page Command Description 

8 crash(M) Corrected pagemode on/off toggle 



option to read -on or -off. 
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init(M) 



Run level 0 is now used for shut- 
downs (formerly run level 5). 



7 



keyboard(M) 



Modified Keyboard Keys table and 
added Other Keys table. 



4, 20 



terminfo(M) 



Added information about line 
graphics character set mapping 
with acsc. 



CH-1 



Change Information 



Page Command Description 



26 terminfo(M) Added two more files containing 

terminal descriptions: altos, src 
and terminfo.src. 

3 volcopy(M) Removed references to backing 

up root file system with 
volcopy(M). 
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READER'S COMMENTS 



Manual Title: Altos System V Series 386 Reference (M) 
Part Number: 690-22870-002 

Altos Computer Systems' Publications Department wants to 
provide documents that meet the needs of all our customers. 
Your comments help us produce better manuals. 

Please Rate 

This Manual: Excellent Good Average Fair Poor 



Completeness of information I 1 1 11 I [ 1 1 

Organization of manual _____ 

Adequate illustrations _____ 

Overall manual lH _ _ lZ _ 

Do you find any of the chapters confusing or difficult to use? 
If so, which ones and why? 



What could we do to improve the manual for you? 



If you find errors or other problems when using this manual, 
please write them below. Do include page numbers or section 
titles. 



Name: 

Company: 

Phone: ( ) 



Title: 

Type of system: 

ext. 
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